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Introducing the HP-71 


Congratulations! You have purchased the HP-71, an advanced computational tool that works as easy as 
a calculator but is as powerful as a computer. The rugged design and high performance of the HP-71 
can substantially increase your productivity. 


The HP-71 offers you the following features: 
e Small sized and battery powered for maximum portability. 


e A special calculator mode for performing sophisticated computations while viewing intermediate 
results. 


e A powerful set of BASIC functions, statements, and operators—over 230 in all. Many larger 
computers don’t have a set of BASIC instructions this complete. 


e Advanced statistics functions that enable you to perform computations on up to 15 independent 
variables. 


e Recursive subprograms and user-defined functions, which are usually found in other programming 
languages, now extend the power of BASIC in the HP-71. 


e An advanced internal file system for storing your programs and data. The HP-71 has continuous 
memory. When you turn the computer off, it retains programs and data. 


e A keyboard that can be easily customized for your specific applications. 


Optional extensions for your HP-71 include application modules containing prerecorded, ready-to-run 
programs, a magnetic card reader for low-cost storage and retrieval, and an HP-IL interface that en- 
ables you to add printers, a digital cassette drive, a video interface, a modem, and other devices to your 
portable computing system. 
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How to Use This Manual 


The HP-71 is an advanced computational tool with more functions, statements, and operators than 
many larger computers. The extensive documentation will enable you to use the HP-71 as the solution 
to your scientific and business applications. 
Included with the HP-71 are the following documents: 

e HP-71 Owner’s Manual. 


This manual describes how to use the HP-71. It is written for the user who has an introductory 
level of programming experience. All users should read some portions of this manual, particularly 
section 1, “Getting Started.” 


e HP-71 Reference Manual. 


The reference manual contains complete descriptions of the syntax of every statement, operator, 
and function in the HP-71. After you have learned how to use the HP-71, the reference manual 
will become your main source of information about individual keywords. 


e HP-71 Quick Reference Guide. 
This portable reference guide slips into the computer’s case. It contains memory-jogging informa- 
tion to help you out when the owner’s manual or reference manual are not handy. 
The HP-71 owner’s documentation assumes you have written BASIC programs using: 
e Variables and arrays. 
e Subroutines. 
e Branches, loops, and conditional execution statements. 
e CATH statements. 
2 Printers. 
e IHFUT statements. 
e Comments in program lines. 
If you have never programmed in BASIC, but intend to program the HP-71, you might need to first 
gain some experience in elementary BASIC programming. If you don’t intend to program the HP-71 
yourself, then you don’t need to learn how to program to be able to use the HP-71. The computer is 


designed so that if you wish, you can simply perform calculations and run prewritten programs. The 
owner’s manual shows you how you can do this. 
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All users should read section 1, “Getting Started” to become familiar with the computer’s operation. 
Other sections are optional, depending on what you want to learn about the computer’s operation. The 
following table indicates what you will need to read in order to learn particular skills on the HP-71. 


If you want to learn how to... 


Run a prerecorded program. 8* 
Perform keyboard calculations. 
Perform statistical analysis. 


, 6 
,2 
, 2, 4 
5 
Customize the HP-71. 7 
Write and run programs. 2, 3, 6, 8, 9, 10, 11 


Use advanced programming structures. 12, 13, 14 
Use the HP 82400A Magnetic Card Reader. Appendix C 


1 
1 
1 

Use the internal clock and calendar. 1. 
1 
1 


* Section 8 describes how to write and run programs. If you are interested in simply run- 
ning programs, you need read only the parts of section 8 that show how to run a 
program. 





In the back of the manual you'll find a subject index followed by a keyword index on the inside back 
cover for your reference. 


Part I 
Basic Operation 





Section 1 


Getting Started 


Contents 
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Overview 


This section introduces: 
e The keyboard. 
e The display. 
e Clearing memory. 
e The HP-71 clock. 
e Keyboard calculations. 
e Entering and running a program. 
e Editing a program. 
e Creating user-defined keys. 
e Using previously entered commands. 
e Using direct-action keys. 
e The beeper. 


e The rest of this manual. 


Keyboard Operation 


Most keys on your HP-71 perform one primary and two alternate, shifted operations. The primary 
operation of any key is indicated by the white or black character(s) on the top face of the key. The 
alternate operations are indicated by the gold characters printed above the keys and the blue char- 
acters on the lower faces of the keys. 


e To select the character or operation printed on the top face of a key, press 
only that key. For example: [> ]. 





e To select the alternate character or operation printed in gold or blue, 
press the like-colored prefix key ((f] or [9]) and the operation key. For 
example: [#][CALC ], [9][>]. You can release the prefix key before pressing 
the operation key, or you can keep the prefix key pressed as you press the 
operation key. 


e To select uppercase letters, press the letter key. (If letter keys produce lowercase letters, first press 
[f][LC], then press the letter key). 


e To select lowercase letters, press [9] followed by the letter key. 
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Keys That Execute Immediately 


Most HP-71 keys only display characters when pressed. However, most bottom-row keys are immedi- 
ate-execute keys—they perform an operation when pressed. For instance, pressing [f] followed by 
executes the operation, which erases a character in the display. This operation allows you to 
easily correct typing errors. All shifted and unshifted keys are listed in this manual’s index. 


Typing Aids 


All [f]-shifted keys in the top three rows are typing aids. A typing aid is a key that produces in the 
display an often-used group of characters. These characters can be displayed by pressing only the typ- 
ing aid key instead of all the individual character keys. For instance, to display GO5WE with a trailing 


space, you can either press (f] followed by [S], or press the (G] (0) [S) (UJ (8) [SPC] keys. The gold 
printing above each key indicates the characters each typing aid displays. The diagram below shows 


how these aids are grouped logically to make them easier to use. 


TYPING AIDS 


FOR...HE#T loops 


User defined 


IF...THEN...ELSE keys Statistics 
THEN ELSE FOR | TO NEXT DEF KEY ADD L.A PREDV MEAN SDEV 
CALL GOSUB AETURN GOTO INPUT PAINT OISP OIM BEEP FACT SIN cos 


mrn~(J JOOOOOOO0O00 
sauseensaqac 


Immediate OFF BACK -—CHAR I/A ~LINE USER VIEW CALC CONT 


news” J OIOOCOO|IOGOUO|O 


File manipulation Program line Calculations 
manipulation 


UO: UF U 
U: U: U: 


U 
O 


Other typing aids 
GROUPING OF [f] SHIFTED KEYS 
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Conventions for Representing Keystrokes 


Except for a few cases where keys we ask you to press are indicated in narrative style, this manual 
represents keystrokes in four ways: 


1. Unshifted or shifted keystrokes that display characters are indicated by those characters. For 
example, # means “Press the [x] key” and # means “Press the [9] and [4] keys.” 


2. Unshifted keystrokes that do not display characters are represented by keys printed with the keys’ 
top-face symbols. For example, means “Press the left-arrow key.” 


3. Keystrokes shifted with (f] that do not display characters are indicated by [f] followed by the keys’ 
gold symbols. For example, [f]([BACK] means “Press the [f} key, then the (<] key.” 


4. Keys shifted with [9] that do not display characters are indicated by (9] followed by the keys blue 
symbols. For example, (9)[>1] means “Press the [9] key, then the key.” 


Power On and Off ((ON], [f][OFF]) 


Pressing turns your HP-71 on, while pressing (f][OFF] turns it off. To preserve battery life, the 
computer turns off automatically after 10 minutes of inactivity. 


The Key 


The key acts in a manner similar to that of the RETURN key found on many computers. 
When you press [END LINE], one or more of the following happens: 


e The statement or calculation you’ve just typed is executed. 


e The characters you’ve just typed are stored in memory. For example, when you enter a program 
into memory, you press after you type each program line into the display. 


e The HP-71 may detect an error. In that case, the computer beeps and displays an error or warning 
message. 


Memory Reset, BASIC Mode, and the BASIC Prompt 


The HP-71 has continuous memory, which means memory contents are not lost when the HP-71 is 
turned off. You can clear and reset memory, however, and it’s important to do so now to ensure that 
examples throughout this section produce the results as shown. There are three kinds of resetting avail- 
able to you, IMIT: 1, INIT: #2, and INIT: 3. The last one (IHIT: =) is the one you'll use 
now, since it clears main user memory, also called main RAM (random access memory). (Descriptions 
of the other two resetting operations appear in the “Owner’s Information” appendix, page 273.) The 
following example shows you how to clear memory. 
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Note: The format of the procedure below will be used often throughout this manual to detail a 
series of keystrokes and resulting displays. The keystrokes follow the conventions described on 
page 13. The displays that are the result of your commands and entries are shown as display 
characters inside a “display box.” 


Input/Result 
Press and release these two keys at the same time. 


Your display shows the command for the first 
type of reset. All the keys are now inactive ex- 


cept for (1), (2), (3), and (END LINE). 


Selects a type 3 reset, a memory reset. 
The computer indicates memory is now clear. 


Clears the display. 





The : symbol is the BASIC prompt, showing that you're in BASIC mode. You'll probably do most of 
your work, such as entering and running programs, in BASIC mode. You can operate your HP-71 in one 
other mode, CALC mode, which we’ll introduce in a few pages. The flashing @ symbol is the Replace 
cursor, showing where the next typed character will replace either a blank or another character. 


The Display Window 


The 22-character display is a window through which you view the 96-character line. The following 
keystrokes demonstrate the length of this line and show you the characters and spaces displayed by 
some of the typing aids. | 
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Input/Result 


Press (f], and while holding {f] down, press in or- 
der (Q], (W], [E], and (R). 


*IF THEM ELSE FOR @ The BASIC prompt, =, occupies the first position 
of the 96-character line. 





Press and hold [f], then press the rest of the top 
row keys, left to right, followed by the second row 
keys (L to R) ending with [J]. That is, press and 
hold (f), then press [7], (Y], (0), (4), (0), (PJ, (7), 
(8}, (9), (4), (A), CS), (2), CE), CG), (4), and (i). 


ETURH GOTO INPUT FRIWE Pressing {H] produced a beep, indicating the 96- 
character line is full. Therefore, pressing [J] did 
not change the display. The left arrow at the far 
left edge of the window indicates part of the line 
is out of the display window to the left. The 
cursor is now located at position 96. 





Why is the 96th character position blank in the display shown above? What happened to the T of 
PRINT? When more than 96 characters are entered into one line, the 97th and succeeding characters 
appear in the 96th character position—repeatedly overwriting that position as long as new characters 
are entered. In this case, the last character is the final space of [ISF , the typing aid produced by 


(lI. 
Moving the Display Window ((<], [>], (S)[<], SP) 


The and keys allow you to scroll the display window back and forth along the line. Here is a 
summary of their actions: 


® moves the cursor left one space at a time along the line without erasing characters. If held 
down for longer than about one-half second, this key action repeats. 


® moves the cursor to the right. Otherwise, and act the same. 
e (9][<] moves the cursor immediately to the first character of the line. 
¢ (9]D1) moves the cursor immediately to one space beyond the last character of the line, or to char- 
acter number 96 if the line contains 96 characters. 
Input/Result 
Moves the cursor four positions to the left. 


ETURM GOTO IHPUT PRIW 
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Note: When any character (other than a space) occupies the same location as the Replace cursor, 
this manual will indicate it as shown above. 


ita Moves the cursor to the first character of the line. 


>IF THEH ELSE FOR fT The arrow at the far right edge of the display 
indicates the line continues to the right. 





Moves the cursor to the right end of the line. 


ETUREM GOTO THPUT FPREIWE 





Clearing the Display ([ATTN }) 


When your HP-71 is on, the key becomes the (attention) key. This key performs two 
actions: 


e When a program is not running, clears the display. 
e When a program is running, halts (suspends) the program, and the SUSP annunciator turns 
on. 
Input/Result 
Clears the display. 





When the display is clear, or when the cursor is not displayed, you can always type a statement, a 
calculation, or program line, and then enter it into the HP-71 (by pressing (END LINE ]). If the display 
contains characters but no cursor, the first key pressed clears the display and performs that key’s ac- 
tion. (This is true except for (<], [>], (9](<), and (@)D¥, which produce no action in this situation.) 
We’ll demonstrate these actions as we progress through this section. 


Correcting Typing Errors ((ATIN], [f)[BACK]) 


Two editing tools make it easy to recover from any errors you might make as you proceed: 
e clears the display when no program is running. 
e backspaces the cursor one space and erases the character in that space. 
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Setting the Time and Date 


The HP-71 contains an accurate quartz-crystal clock and a calendar covering several thousand years. 
This clock runs whether the HP-71 is on or off, and begins running as soon as batteries are installed. 
We’ll show you how to set this clock to the correct date and time. 


The example below assumes the date is May 20, 1984, and the time when the clock setting process 
begins is 4:13 PM and 10 seconds. Read through this example to learn how to set your clock to the 
correct time and date. 


The HP-71 requires a year/month/day (YY/MM/DD) format for the date, and six digits must always 
be entered, including leading zeros. 


Example: Set the date for May 20, 1984. 


Input/Result 
SETORTE"S4-@5.-20" Sets the date. 





Enters the date. 





DATES Displays the date. 





We'll describe a technique to set the clock with an accuracy of 1 second or better. Read the following 
description, then set your clock. 


Key in a time about 30 seconds ahead of the actual time and press when the actual time 
catches up with the keyed-in time. 


You don’t need to clear the display before pressing the next group of keys. When the cursor is not 
displayed, the next keystroke clears the screen and enters that key’s character into the display. 
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Input/Result 


SETTIME"16:14:68" This statement sets the time. The HP-71 clock 
uses the 24-hour format, and six digits must al- 
ways be entered, including leading zeros. The two 
zeros following the second colon are the seconds. 


Suppose the typing of this SETTIME command is finished at 16:13:30. Now look at a watch that 
shows seconds, and get in the rhythm of counting in half seconds. At one-half second before 16:14:00, 
press [END LINE], and the HP-71 clock is set with an accuracy of a few tenths of a second. Page 92 in 
Section 5 describes how to adjust the clock’s setting, and page 94 describes how to adjust the clock’s 
speed. 


The TIME function returns the current time. To display a changing clock, a simple program is re- 
quired, such as the CLOCK program on page 131 in section 7. 


Suppose you execute TIME# exactly one minute after executing =ETT IME: 


Input/Result 
TIMES Displays the time as a string, not a numeric value. 


This is the time you executed TIME. 





Keyboard Calculations 


You can perform calculations on the HP-71 in two different modes: 


e In BASIC mode, keyboard calculations are performed as they are on most BASIC language 
computers. You first key in the entire expression, then press to obtain the result. 


e In CALC mode, you key in the entire expression as you do in BASIC mode, but whenever the 
portion of the expression already keyed in can be evaluated, the HP-71 automatically displays the 
intermediate result. You then press to obtain the final result. 


The ability to monitor the progress of a calculation by viewing intermediate results provides important 
advantages compared to viewing only the final result: 


e You can see if the calculation is progressing as you expect, allowing you to catch errors that other- 
wise might remain hidden. 


e You can understand more easily and completely how an expression behaves, which is often more 
useful than the final result. 
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The expression we’ll evaluate is: 
7+4-—9 x (15 — 7/3). 


To ensure that the results of calculations you display on your HP-71 look like those in this manual, 
execute the following statement. 


Input/Result 
Fike 


The HP-71 will now display results rounded to 
two decimal places. 


BASIC Mode Calculation. 


Example: Evaluate the expression in BASIC mode as follows. 


Input/Result 


Pt4-SeC15-F 633 


The expression is keyed in, ready for evaluation. 


Evaluates the expression. 


The result. 





CALC Mode Calculation. 


Example: Evaluate the same expression in CALC mode. 


First, set the HP-71 to CALC mode. If you make an error as you enter the expression, press (f ][BACK ] 
enough times to erase the mistake, then complete the expression correctly. 


Input/Result 


[f)[CALC) 


# The annunciator tells you you’re in CALC mode, 
calc | and the flashing Insert cursor (page 21) says that 


characters will be inserted into the display from 
the right edge. 
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As soon as you key in an operator in CALC 
mode, the HP-71 accepts the most recently typed 
operand and displays it in the same format as a 
result. 





When you key in ~, the HP-71 not only enters 
the +, but evaluates and displays the intermediate 
result. 








This display shows two CALC mode features: 


e The HP-71 does not evaluate 11 .&&-%,44, since to do so would violate operator precedence 
(section 2, page 64). 

e The Insert cursor shares its position with a right parenthesis, reminding you that the expression 
requires a matching right parenthesis. 


Input/Result 


Late o 


~~ ” 


When you key in the closing parenthesis, the 
flashing 3 reminder disappears. If an expression 
includes several nested pairs of parentheses, the 
closing parenthesis reminder remains until the fi- 
nal pair is closed. 


: Evaluates and displays the final result. 








Now set the HP-71 back to BASIC mode by pressing [f][CALC]. (The keystroke is a toggle. 
Pressing it switches back and forth between CALC mode and BASIC mode.) 
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Entering and Running Prewritten Programs 


The next few pages show you how to convert a program listing on paper into a program in memory, and 
then how to execute that program. Since you might make an error as you enter program lines into the 
HP-71, we'll first describe some error-correcting tools that allow you to display and edit program lines. 


Displaying Any Program Line ({A], [¥], (9][«], (9][y)) 


When you're entering or running a program, these four keys allow any program line to be displayed for 
viewing or editing. Any line brought to the display using these keys becomes the current line. Shortly, 
actions of these keys will be demonstrated when you enter a program. 


® brings the line preceding the current line to the display, ready to edit. If held down for longer 
than about one-half second, its action repeats. 


e brings the line following the current line to the display, ready to edit. If held down for longer 
than about one-half second, its action repeats. 


e (9)(A] brings the lowest numbered line to the display, ready to edit. 
e (9][y] brings the highest numbered line to the display, ready to edit. 


Editing Any Line ((+](6ack], [f)[=cHaR], [fJLI/R], [fJLELINE)) 


These four keys, when used in BASIC mode, allow you to change any displayed line: 


e [f][BACK] backspaces the cursor one position and erases the character at that position. If held down 
longer than about one-half second, its action repeats. 


e [f][-CHAR] erases the character at the cursor and moves characters left one space to fill in the gap. 
If held down longer than about one-half second, its action repeats. 


e (f]L1/R] switches between the Replace cursor (™) and the Insert cursor (#). A character typed when 
the Replace cursor is showing replaces the character or space at the cursor. A character typed when 
the Insert cursor is showing is inserted where the Insert cursor points; that is, between the char- 
acter at the cursor and the character immediately to its left. 


e (f][-LINE] erases all characters starting from the character at the cursor through the right end of 
the line (which might include more characters than those immediately visible in the display). 


Naming a Program File (EDIT) 


Note: To help you find typing aids more easily, the keystroke sequences on the next few pages will 
show key symbols above the characters displayed by the typing aids. For instance, ELI T will be 
shown as: 


((4)(Z)) 
EDIT. 
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The HP-71 can hold many programs. Each program is stored in a location called a file, which you must 
identify by a file name. A file name can be up to eight characters long. The first character must be a 
letter, and the remaining characters may be letters or digits. 


You'll soon enter a program into memory. First, create and name the file that will contain this program 
using the EL. IT statement. 


Input/Result 


(LJ(Z)) 
EQNIT OVERFLOW 


The OVERFLOW file’s catalog entry is dis- 
played, and the file is now ready for the (WER — 
FLO program. 





The right arrow in the display shows that the catalog entry continues to the right. This display in- 
dicates the OVERFLOW file is an empty BASIC file. File catalogs are covered in section 6 starting on 
page 117. 


Entering, Editing, and Running the 24/EF FLOM Program 


As you enter a program into memory, any errors you might make can be of two types: 


1. Errors you catch before pressing [END LINE], or errors the HP-71 recognizes as soon as you press 
END LINE |. 


2. Errors neither you nor the HP-71 recognizes until you run the program. 


You might make both kinds of errors as you enter this and other programs. To help you recover from 
such errors, we'll deliberately introduce one error of each type and show you how to correct each one. 
(Errors and error recovery are covered in more detail in section 9). 


Following this listing of the O'JERFLOM program, we’ll show you how to enter each line (including the 
two deliberate errors). Note that program lines that start with |! are comments, which are ignored by 
the computer when the program is run. However, the HP-71 does reproduce such comments in program 
listings. The = symbol joins (concatenates) statements on a single line. 


10! OVERFLOW PROGRAM Note: If you later display (list) line 40, the first pair 

20 REAL X,Y @ STD of parentheses will be gone. (The HP-71 doesn’t 

30 FOR X=1 TO 20 | keep such mathematically unneeded parentheses. 

40 Y=(X*2)*(X*2) @ They're used here as an aid to understanding the 
DISP Y @ IF Y=MAXREAL THEN 60 expression.) 

50 NEXT X 


60 “The largest finite positive number the 
HP-71 can display is’;Y 
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In the following keystroke sequence, type the spelling errors as shown. We'll correct them shortly. 


Input/Result 
16 ! OVERGREOM FOGRAM 


We’ll correct the line to read 
OVERFLOW PROGRAM. 





1H ! OVERFLOW FOGRAM 





OVERFLOW #FROGRAM The Insert cursor points to the position where the 
next typed character will be inserted. 





OVERFLOW PROGRAM 





Enters line 10 into your program file. The 


key acts with either the Insert or the 
Replace cursor displayed at any position. 


26 REAL H,Y @ STO REAL #. ¥ (page 57) declares variables and ‘i 
to be full precision, and STU (page 55) sets a 
display format that shows numbers with full 
precision. 
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(LR) = (J) 


au FOR 


m=l TO 2 LENDLINE 





(L*jLQ)) (LAW) 


@ IF Y=MAARERL THEH && 


VSMASREAL THEH 





(CAJLY)) 
Sa WEST # 








The variable ‘' at the end of the program line (fol- 
lowing the !# symbol) is an implied (LI '3F° state- 
ment. It means the same thing to the computer as 
DISF ‘'. Implied 01 SF statements are ex- 
plained further on page 67. (The HP-71 also al- 
lows implied LET statements). 


The first pair of parentheses will not appear when 
you subsequently display this line. (Refer to the 
note on page 22.) 


Note the spaces given by the typing aids. 
MAXNREAL is the HP-71 name for the largest 
finite positive number it can represent. 


The left arrow annunciator indicates the rest of 
this line is to the left of the displayed portion. 


[f][LC] switches between the letter cases. It sets 
upper- or lowercase letters as the standard for 
unshifted letter keys. In either situation, a (g]- 
shifted letter key produces the opposite letter 
case. 
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t® positive number th Continues line 50. 


t@® positive number the 





When typing the next part of line 60, use the (9) shift key to type HF. (We'll explain how to correct the 
1° error after we run the program.) 


Input/Result 


e& HF-if can display i 
dizerlayu 18 


[t][LC] switches back to uppercase. 





Enters line 60 into your OVERFLOW file. The 
complete program is now entered. 





Press to execute this program. 


The PRGM annunciator on the right edge of the display appears, and a series of increasingly large 
numbers is displayed, one after the other, including i . E288. The E means “exponent,” so this num- 
ber represents 1 x 107. Just after you see 1,231599351595E449, a warning message, 
WRH L46:Over law is displayed. This means the next number in the series is larger than the 
HP-71 can represent. Since this difficulty results in just a warning and not an error, the program 
continues, and substitutes for the next number in the series the largest number the computer can 
represent, 2, 3355999599 999E499, 

As line 60 displays its message, you realize the model number of your computer is “71,” not “17.” Here’s 
how you enter the correction into the program after the program stops. 
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Input/Result 


(LeJLB)) 
FETCH 6&8 Brings line 60 to the display. 


PBABODISP "The largest Fetching a program line positions the cursor im- 
mediately after the line number to facilitate 
editing. The right arrow annunciator shows the 
line continues to the right. 


(gD) Moves the cursor to the right end of the line. 





man disrlay is": EH 





Press 20 times. Or hold down until the 
cursor is close to or at the 1. Then use or 
as needed to correctly position the cursor. 





? 1 (END LINE The program is corrected. 


Controlling Program Display Speed (D.ELA‘ 


LiELAY line rate [. character rate] 


You have control over how many seconds a line is displayed before being replaced by the next line (line 
rate), and also how fast a displayed line containing more than 22 characters scrolls from the right (the 
optional character rate). You can choose a /ine rate and a character rate from 0 up to 8 seconds. A rate 
equal to or over 8 seconds is considered infinite—no line replacement or scrolling occurs. These two 
parameters are independent of each other. 


1 
: 
: 
| 





Ee a a a ae ee ee eS ee el Re we eR Me eRe Ce ge SNP ee Bn 


section 1: Getting Started 27 


Saving the TViERFLOW Program (EQ IT, HHME) 


Suppose sometime later you wanted to enter a new program, and forgot to create the new file using the 
ELI T statement before keying in the program’s lines. Where would those new lines go? They would go 
into the same file the O'ER FLOW program’s lines went: into the file named OVERFLOW. The lines of 
your new program would overwrite the lines of the (\JERFLOM program, corrupting both programs. 


One way to guard against such an accident is to create a new program file before keying in any lines, as 
you did when you executed EX IT OWERFLOM. A second way is to make available a scratch file named 
work ile, which will accept any new program lines you enter. To make the work file available, 
execute ED. IT without specifying a file name. 


Input/Result 
EQIT 





This is the first part of the catalog entry for your new file, showing that the file is an empty BASIC 
file. File catalogs are covered in section 6 starting on page 117. 


Ifa work file exists (even if it’s empty), EDIT positions you at that existing work file, 
not at a newly created work tile. The HP-71 can contain only one work file. 


You can create a new, empty workfile (using ED IT({ENDLINE]) if you first name the existing 
workfile using HAME filename. See section 6, pages 100-102 for further information about 
work file and HAME. 
To summarize, when you key a program into your HP-71, it is good practice to: 

1. Create a new file by executing EDIT file name. 

2. Enter the program lines, test the program, and edit the program as necessary. 


3. Select the work file by executing EDIT. 


Running Any Program in Memory 


There are two ways to execute a program: 
e Execute F:LIH file name. This works for any program. 


e Press (or execute FILIH). This works only for a program located in the current file, explained 
below. 
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Running the Program in the Current File. At the moment, work file is the current file. The 
HP-71 always contains one and only one current file. When you enter a program from the keyboard, it 
is automatically entered into the current file, and you can run it by pressing or executing FLH. 
You can edit the program in the current file from the keyboard, as you edited OVERFLOW. 


Running Other Programs. You can run any program by executing F:LIH file name. A program that is 
not located in the current file must by executed in this way. When you execute such a program, it 
becomes the current file, so you can edit it, and you can use the key to repeat its execution. 


Redefining the Keyboard ((f][(USER], (9)[1 USER ]) 


The HP-71 includes two complete and separate keyboards that share the same physical keys. The Nor- 
mal keyboard, the one you’ve been using, performs the actions indicated by the symbols printed on and 
above the keys. The User keyboard performs those same actions except where a key’s operation has 
been redefined--that is, user defined. There are two ways to switch between these two keyboards: 


e [F](USER] switches from one keyboard to the other. To switch back to the earlier keyboard, press 
(f)LUSER } again. 


e (S\[1 USER] switches from one keyboard to the other for only one shifted or unshifted keystroke, 
then the HP-71 automatically switches back to the earlier keyboard. 


You can redefine the shifted and unshifted action of all but two keys. The two keys you cannot redefine 
are the two shift keys themselves, [f] and (@]. Key actions can be redefined to display a typing aid of 
your choice, or to execute any statement, or combination of statements, concatenated with i, that are 
executable from the keyboard. User defined keys can also be used to assist data entry in response to 
program input requests. You can use the entire 96-character line length for your key definition. The 
beginning of section 7 discusses user defined keys in more detail. We’ll now lead you through creating 
and using a simple key assignment. | 


Enter the following key definition: 


Input/Result 
(HWW) 
COEF KEY “<", "TIMES" Redefines (9][<] to display the current time when- 


ever (9][<] is pressed from the User keyboard. 
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We'll show two ways the user-defined key [9][<] can be used. 


Input/Result 
[fJLUSER ] Activates the User keyboard. 


The USER annunciator tells you the User key- 
board is active. 


This display represents a time of 4:59:39 PM. 


The USER annunciator is off, and once again the 
Normal keyboard is active. 





Here’s another way to use the same redefined key: 


Input/Result 


[9}(1_ USER} (9)[<} | Simply press and hold down [9], then press in or- 
der the (0) and [-] keys. 


Notice that the USER annunciator is not on. The 
(9 [1 USER] keystroke activates the User key- 
board only for the next shifted or unshifted key- 
stroke. After that next keystroke, the Normal 
keyboard is automatically active again. 





Display Contrast and Viewing Angle (2. iF? 227) 


COMTEAST contrast value 





The COHTRAST statement allows choices for contrast value, from & to 15, which control display 
intensity and optimum viewing angle. CONTRAST & gives the least contrast and shallowest viewing 
angle, and “UOHTRAST 15 gives the sharpest contrast and steepest viewing angle. COHTRAST 15 
also makes all the annunciators easily visible. After memory reset, contrast value is set to = (the default 
value). You can adjust contrast value to suit your personal preference. 








30 Section 1: Getting Started 


Input/Result 
COHTRAST 15 


0) => 
1 PRGM 


If you look directly down on the keyboard, you'll 
see the BASIC prompt and cursor displayed with 
strong contrast. If you now tilt your HP-71 away 
from you, you'll see all the dots used to make 
characters plus al] the annunciators. 





Status Annunciators 


Here are brief descriptions of the HP-71 annunciators. 


























The line extends to the left of the display. 


[9] has been pressed, but not the second key required to complete the key 
sequence. 


[f] has been pressed, but not the second key required to complete the key 
sequence. 


Reserved for future use. 
Low battery. 

The User keyboard is active. 
The angular setting is Radians. 

Flag 0 is set." 

Flag 1 is set. 

Flag 2 is set. 

Flag 3 is set. 

Flag 4 is set. 

Reserved for future use. 

The line extends to the right of the display. 
A program is running. 

A program is suspended. 
The HP-71 is in CALC mode. 


“Flags are covered in section 11. 
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Now return your display to normal contrast. Execute: 


COHTRAST 3 


Recalling Commands—The Command Stack ((9][CmDs]}) 


A list of the five most recent commands is maintained in a separate part of memory called the Com- 


mand Stack. “Commands” refer to operations that have been executed by pressing [END LINE], such as 
evaluated expressions and entered program lines, statements, and functions. Any command in the 


Command Stack can be displayed and executed again (by pressing [END LINE]), or edited, then executed. 
The Command Stack is especially useful when repeatedly executing a series of commands, all of which 
are identical or contain only minor differences. 


If any of the last five commands are identical, the Command Stack maintains only the one most re- 
cently implemented. 


Here’s how you activate and deactivate the Command Stack: 
¢ Activate the Command Stack by pressing [9][CMDS]. 
¢ Deactivate the Command Stack by pressing [9)[CMDS] again or pressing [ATTN]. 
¢ Deactivate the Command Stack and execute the displayed command by pressing [END LINE J. 


We'll show you how to display a few of the commands you've just entered. 


Input/Result 
[S9][CMDs ] Activates the Command Stack. 


“CONTRAST & The display shows your most recently executed 
command, together with the Replace cursor. The 
». symbol is the Command Stack prompt. All 
cursor-moving and editing keys are active. 


Use the and keys to move through the 
Command Stack. You display progressively older 


commands by pressing repeatedly, and more 
recent commands by pressing [V]. 


~COMTREAST 15 This is your older command. 





You can execute (by pressing [END LINE]) any 
expression or statement displayed by the Com- 
mand Stack, or enter any program line displayed 
by the Command Stack. 
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0 () =» 
1 PRGM 


Pressing executes the displayed com- 
mand (COHTREAST 415) and deactivates the 
Command Stack. CGHTEAST i is now your 
most recently executed command. 


(g)(cmps } Reactivates the Command Stack and displays 
your most recently executed command. 





0) > 


caat CONTRAST 15 ae 
. 4 





Displays the older command. 


CONTRAST 3 
D 





Executes the displayed command and deactivates 
the Command Stack. 


The BASIC prompt shows that you have deacti- 
vated the Command Stack. 





The EEEF statement produces an audible signal whose frequency and duration you can control. You 
can also turn off this signal, and choose between two levels of loudness. The main application of the 
beeper is to provide audible warnings. 


There are five forms of this statement: 


BEEF 
BEEF frequency in hertz 


EEEF frequency in hertz. duration in seconds 
BEEF OH 
BEEF OFF 
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Here are facts about EEEF: 


¢ When you execute EEEF without specifying frequency or duration, a 500 Hz signal sounds for .25 
second. 


e You can specify frequency up to a maximum of about 4900 Hz. Frequencies as low as 150 Hz 
produce recognizable tones. 


e You can specify duration as long as 1000 seconds. 


e You can specify both frequency and duration as numeric expressions. The HP-71 evaluates these 
expressions when EEEF is executed. 


e EEEF (lH enables the beeper. 
e FEEF (FF disables the beeper. 
e After memory reset, EFEEF 0H is active. 


¢ You increase the intensity of the tone by executing SF LAG-=5 (set flag number — 25). (Flags are 
covered in section 11.) 


¢ You decrease intensity to the memory reset level by executing “FLAG-2£5 (clear flag number 
— 25). 


What’s Ahead 


You’ve sampled the HP-71 in this section. There’s much more information ahead, but you don’t have to 
read it all. If you’re primarily interested in using prewritten programs, you need read only sections 6 
and 8 to become familiar with the HP-71 file structure and to learn details on running programs. Read 
section 2 if keyboard calculations are important to you. If you plan to solve statistical problems with- 
out using prewritten programs, read sections 2 and 4. 


For programming help, look at sections 2, 3, 6, and 8 through 14. You might also wish to read section 5 
(clock) and section 7 (User keyboard). 


Check the appendixes and the reference manual to see what’s there. For example, the reference manual 
contains a glossary that defines many of the terms used in this manual. 
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Syntax Guidelines 


Syntax is the way that instructions must be typed so they can be understood by the computer. The 
following conventions are used throughout this manual. 


QOT MATERIA TYPE 


italics type 


[ ] 


stacked items 


Words in dot matrix (like DEF KE‘) can be entered in lowercase or upper- 
case letters. The examples in this manual show statements, functions, and 
operators entered in WFFERCASE. 


Items in italics are the parameters you supply, such as the file name in the 
HAME file name statement. 


Character strings can be enclosed with single or double quotes and can be 
entered in lowercase or uppercase letters. (The examples use double quotes.) 
In general, file names can be quoted (single or double quotes) or unquoted. 
When quoted, the left quote must match the right quote. (The examples use 
unquoted file names.) The HP-71 converts file names to uppercase. 


Square brackets enclose optional items; for instance, DELH’ line rate 
[: character rate]. 

When items are placed one above the other, one and only one must be 
chosen. 

An ellipsis indicates that the optional items within the brackets can be re- 
peated; for instance, HED [coordinate value 1 [. coordinate value 2[...[.co- 
ordinate value 15]... ]]]. 


The descriptions for keywords (statements, functions, operators) that appear in this manual allow you 
to use them effectively. However, these descriptions often do not include all details. Syntax descriptions 
that omit some detail are labelled “simplified syntax.” For a complete and detailed definition of each 
keyword, refer to the “Keyword Dictionary” in the reference manual. 
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Calculating with the HP-71 
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Range of Numbers (MH IHFEAL, EFS, Mute Me) Sip RA aye Reape Beil Artes one dos eo 61 

Relational Operators (Combinations of <, =, >, #, FY) o.oo... eee. 62 

Logical Operators (HHO, GF, EXOR, HOT) iis boa od oi ater hoc yia-e So aca ees 62 

Precedence of Operators ........... 0.0... ccc eee ence eee nneeas 64 
| Overview 


This section covers: 
e A new way to calculate with a computer: CALC mode. 
e All math operators: arithmetic, relational, and logical. 
e All math functions. 
e Random numbers and how to use them. 
e Three ways to format a displayed number. 
e The precision of displayed and stored numbers. 
e The math exceptions: invalid operation, division by zero, overflow, underflow, inexact result. 
e The three responses to each math exception. 


e The [EEE Proposal for handling math exceptions. 


Using CALC Mode 


You can evaluate a numeric expression with the HP-71 within two different frameworks. Each uses the 
normal algebraic precedence of operators (page 64). (For instance, terms within parentheses are evalu- 
ated first.) 


e BASIC mode, which is the familiar framework shared by most BASIC computers. You key in the 
entire expression before any evaluation occurs, then you press to evaluate the expression 
and display the result. 


e CALC mode facilitates evaluation in many ways not available to BASIC mode, including the dis- 
play of intermediate results while the expression is being keyed in. 


CAUTION 


Do not insert or remove a module while CALC mode is on. Doing so will cause a memory reset (loss 
of memory). Refer to section 6 for more information about the use of plug-in modules. 





38 Section 2: Calculating with the HP-71 


CALC Mode Features 


The following list of features, some illustrated with examples, shows how you can use CALC mode to 
your advantage to evaluate numeric expressions. 


Complete Numeric Function Set. All HP-71 numeric functions and operators can be used in CALC 
mode, including the single-statement user-defined numeric functions in the current file. 


Common Variable Set. CALC mode and BASIC mode share the same set of variables. A variable 
assigned a value in BASIC mode retains that value in CALC mode, and vice versa. 


User-Key Assignments. You can use User keyboard key assignments in CALC mode, except for ex- 
ecute-only (colon) key definitions. (Key definitions are covered in section 7.) 


Unbounded Complexity in Expressions. Any numeric expression that can be keyed in and evalu- 
ated in BASIC mode can also be evaluated in CALC mode. 


Twelve Digit Math. Intermediate results are carried with 12 decimal digits of precision. 


Assignment Statements. Variables can be assigned values and used in expressions, as the following 
example shows. 


Note: For this and the other examples that illustrate some of these CALC mode features, you 
should be in FI# <= display format so your displays will look like those in this manual. You cannot 
execute FI = while CALC mode is on, so make sure you’re in BASIC mode. (If the CALC 
annunciator is displayed at the right edge of the display window, press [f][CALC] to set BASIC 
mode.) You should see the BASIC prompt (2) at the left end of your display window. If your display 
is not clear, press [ATTN ]. 


Input/Result 
Fine 


Entered numbers and results will be displayed 
rounded to two decimal places. 


Lf JLCALC } Sets CALC mode. 


# 
CALC 
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Starts the assignment statement example. 





So far, no partial evaluation has occured. 


You evaluate a partial result as soon as you 


press [-]. 


Terminates the expression and assigns its value 


to FA. 


Use FA in an expression to confirm that it now | 
represents ~— 3, 2H. / 


As soon as an operator (#) is keyed in, Fi is re- 
placed by its value. 





Displays the answer. 





Automatic Parenthesis Matching. For every left parenthesis you enter, the HP-71 automatically | 
supplies a right parenthesis. So you need not key in closing parentheses at the end of a line. However, if 
you do type closing parentheses, the HP-71 accepts the correct number, and no more than the correct 
number. 


i vet tere ESI TIME RTT GAT te ro Ceara 


eres a 


Ff ne dsm 
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Input/Result 


SIH Se The typing aid above the (4] key supplies 31H 
and the left parenthesis. 


The flashing right parenthesis sharing the 
cursor’s position represents a number of right 
parentheses equal to the number of open left 
parentheses you’ve keyed into the expression so 
far. In this case, that number is one. 





[END LINE) 


You did not have to press either {(] or [)] to 
evaluate this expression. 





Implied Result (<>). A pair of empty parentheses keyed in as part of the current expression repre- 
sents the value of the last evaluated expression. The current expression then uses this current value. 
The empty parentheses pair can either represent a separate term in the expression or the argument of a 
function. 


Input/Result 
ASTH¢ 





Pressing enters the closing parenthesis, 
supplies the previous result represented by the 
pair of empty parentheses, and evaluates 
HSIN, Seo. 





A= This demonstrates another important use of im- 
plied result. 


The previous result, 24. 4, is now assigned to 
the variable FA. 





Comma Reminder for Argument Lists. For those functions and arrays requiring two or more ar- 
guments, the display indicates the minimum number of commas required in the argument field. 
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Input/Result 
MIHGS Key in the first argument of a fiI}H function. 


The comma sharing the cursor’s position in- 
dicates at least one more argument is required. 





ue Key in the comma and the second argument. 
Since the character following the = could be a 
comma, or a continuation of the first expression 
(such as another numeral), you must supply the 
comma from the keyboard. 


MICS, BA, 2? The flashing parenthesis tells you no more ar- 
guments are required. 





Again, you did not need to key in the closing 
parenthesis before terminating the expression. 





Viewing Each Step Separately ((f][SST] or [RUN]). When you key in an expression with CALC 
mode active, there are times when several terms will appear to be evaluated simultaneously. In these 
situations, you can view each intermediate result separately without violating the order in which oper- 
ators should act (order of precedence). | 


Example: Suppose you wish to evaluate log(11) + 3°2 — 4, and you also wish to see the intermediate 
result given by 3-2. (Note the typing aid [f](LOG] for L1G and that (g][*] displays *). 


Input/Result 


LOGeLis+3"3,2 Since you’re interested in the value of 32°23. =, do 
not key in ~4 yet. If you did, 
LOG¢113+3°3.,2 would be evaluated as soon 
as you keyed in ~, and you would not see the 
result given by 22.2 alone. 





ELEN Er i REIS ETE ee etme Oe 


and perform the same action with 
CALC mode active. 


Single-step displays the value of 2". =. 
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— 4 | END LINE 


The final answer. 





Example: CALC mode will not allow you to violate the proper order of operator precedence when you 
single step through an expression. To illustrate this, use the expression = +2%#4. 


Input/Result 
a3 Displays the intermediate result. 
ao, Ao # 
CALC 
[ « ] Now you try to key in #, but multiplication is not 


performed. Instead you see: 


WR: Precedence You're told multiplication should have been per- 
formed before addition. 





2, Ee The earlier display soon replaces the warning 
CALC | message. 


We'll soon show you how you can easily recover from this error by activating the Command Stack. 


Recovering the Complete Expression ({a]). When you press {a], you activate the Command 
Stack. (Pressing [ a] activates the Command Stack only when CALC mode is set.) The resulting display 
can be of two types: 


e The display shows all terms of the last evaluated expression plus the symbol, «!, indicat- 
ing an expression has just been evaluated. 


e The display shows all terms of the expression being keyed in whose final result has not yet been 
evaluated. This Command Stack display recovers the individual operands and operators you 
originally keyed into the HP-71. 


In either case, you can edit the displayed expression using the Command Stack’s movable cursor. 
Different actions are performed by (Command Stack active) depending on the presence or 


absence of «! in the display. Here are those actions: 


e . not displayed: deactivates the Command Stack and displays the partially evaluated 
expression, including the effects of any Command Stack editing. 


e .« symbol displayed: evaluates the displayed expression (including the results of any 
editing), deactivates the Command Stack, and displays the final result. 





Input/Result 





[>} (>) @) #4 LEND LINE} 
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Activates the Command Stack and recalls the 
original form of your expression so you can cor- 
rect your operator precedence error. 


The cursor is ready for editing use. 


Completes the expression and deactivates the 
Command Stack. 


In this case, displays the same 


unevaluated expression. 


Displays the result. 


Suppose you wish to evaluate the expression 6 — 3’, and key in 6+2%*-7, then evaluate it before you 
realize your error (+ instead of —). As this example demonstrates, you need not reenter the complete 
expression. You can activate the Command Stack, edit your expression, and reevaluate it. 


Input/Result 





Displays an incorrect result. 


You now realize you should have keyed in -, 
not +. 


Activates the Command Stack. 


The symbol (+!) indicates that you 
pressed just before you activated the 
Command Stack. 





| 
‘| 
| 
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= Corrects the expression. 


Evaluates the correct expression. 


When the Command Stack expression displays 
4, pressing reevaluates the expression. 


Backward Execution ([f][BACK]). Before an expression is completed by pressing [END LINE], terms 
that had already been combined to display a partial result can be restored to their original form using 


[tJLBACK]. 


Example: To demonstrate the use of backward execution, suppose you key in an expression (4.°9#3%), 
and before evaluating it, you realize you keyed in a wrong number (8 instead of 9). You then use back- 
ward execution to erase elements of the expression back to and including the wrong number (8). After 
keying in the correct number (9), you complete the expression and evaluate it. 





a Enters the incorrect expression. 


The HP-71 displays the partially evaluated 
result. 


LtJLBACK] [#)[BACK] [f][BACK] Erases operands and operators back to and 


including the incorrect operand (2) you entered. 





You’re now ready to complete the correct 
expression. 


SE 3 [END LINE Completes and evaluates the correct expression. 





hr 
i] 
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Correcting Typing Errors 


If you try to complete a function after you misspell its name, the HP-71 will issue a warning. After 
such a warning, erase all characters of the misspelled function name using backward execution, even if 
the display suggests this in unnecessary. Then type the name in correctly and complete the expression. 
This example shows why this is necessary. 


Example: Suppose you wished to evaluate an expression which includes HHGLE«—-S, 43 (arc tangent 
of +.°.~3 in the proper quadrant), and you make a typing error as you key in AHMGLE. 


Input/Result 
o°4+C05¢AMGLE You inadvertently press (M] instead of (NJ. 


You don’t notice your error, so you continue. 
Generates a warning message. 


WEH Operator Expected We'll discuss the meaning of this message 
shortly. This message is soon replaced by: 


You’re determined to spell it right this time, so 
you key in: 


HGLE¢ and see: 





WRASUpersator Expected replaced quickly once again by: 


What’s happening? 





When you typed AMGLE*, the HP-71 searched for a function with that spelling. When it couldn’t find 
one, it searched for a variable name instead, and found A. After a variable name, the HP-71 expects an 
operator, which Mi2LE is not. So all characters after the A were discarded. When you typed HGLE<, 
the display looked fine, but the HP-71, still looking for an operator, rejected HGL FE just as it had 
HGLE. To recover from this situation, use backward execution ((f][BACK]) to erase 4, then key in the 
correct characters: 
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Input/Result 


LAJLBACK) 





AHGLEC-5, 43 Corrects your typing error and evaluates the 
expression. 





Unsupported Operations 


Since CALC mode is a powerful, friendly, and intelligent environment for keyboard calculations, rather 
than a replacement for BASIC mode, we want you to know what operations cannot be performed in 
CALC mode. CALC mode does not support: 


e Strings. 

e The decimal and hexadecimal conversion functions [i TH# and HTL. 
e Multi-lined, user-defined functions. 

e Statements, except assignment statements. 


e Program lines. 


Warning Messages in CALC Mode 


In the following CALC mode cases, check the contents of the Command Stack before proceeding. 
e You are evaluating an expression in the Command Stack and get a warning message (any kind). 
¢ You are performing backward execution ([f][BACK]) and get a warning message. 


e You press a user-defined key on the User keyboard and get a warning in response. 


Note that characters coming after those that generated the warning may not have been accepted. 


a ee oe ee ee ee ee a; 





F 
Y 
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Arithmetic Operators (+, ~, #, “, “, G2, %) 


3 


The HP-71 adds *: to the usual set of BASIC arithmetic operators. This table shows how these oper- 
ators are used. To reproduce the results shown in this and the following tables, execute STE 
in BASIC mode to set STC display format (discussed on page 55.) 


Arithmetic Operators 


Operator 


Addition 
Subtraction 
Multiplication 
Division 


Exponentiation 


Integer Division (no remainder) 


The operation x*:y returns 
X percent of y. 





Numeric Functions 


Numeric functions are built-in routines that take numeric or string information and return single val- 
ues. The information acted on by a function is called the argument of the function. An HP-71 function 
can operate on zero or more arguments. An argument can itself be a variable, another function, or an 
entire expression, so long as it reduces to a single value at the time it’s evaluated. 


To execute any HP-71 function from the keyboard: 


1. Type the function name. 


2. Type the argument, if the function requires one, enclosed within parentheses. If the function re- 
quires multiple arguments, separate them with commas. 


3. Press to compute the result. 


The following topics group the HP-71 numeric functions according to their use. 
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Number-Alteration Functions (HES, IF, FF, THT, FLOOR, CETL) 


The table below shows the value returned by each function from a numeric expression x. For instance, 


7 


the example for HE Sx? shows that 225 is returned when x reduces to ~225. 
Number Alteration Functions 


Function and 
Argument 


Absolute value of x. 


Integer part of x—that portion of x to the left of the decimal 
point. 


PRP aXx? Fractional part of x—that portion of the number to the right of 


the decimal point (including the decimal point and sign). 
THT xs The greatest integer less than or equal to x. 


FLOOREXs Greatest integer less than or equal to x. (Same as THT «x:.) 


GELLGxX Smallest integer greater than or equal to x. 





Notice the difference between the IF, FLOOE (or IIHT), and CEIL functions. Given a positive ar- 
gument, IF and FLOCF return identical values; given a negative argument, IF and CEIL. return 
identical values. 


Decimal and Hexadecimal Conversions ((.TH#, HITE) 


These two functions cannot be executed in CALC mode. To use the result of HT[! in CALC mode, 
switch into BASIC mode ([f][CALC]), execute the function to get the result, switch back to CALC 
mode, then type “2? to automatically display the same result. This result can then be used in further 
calculations. 


Decimal and Hexadecimal Conversions 


Function and Example with Result 
Argument 


Converts a positive decimal number no larger than 16° — 1 


(=1048575) to a string that represents its five digit 
hexadecimal value. 


Converts a one to five digit hexadecimal value to a decimal HTD AAP YO 
number. The hexadecimal value must be entered as a String. 44111 
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General Functions (FI, SGF, FACT, MAX, MIM, MOO, RAO, REQ, RES, 
SGH) 

These general functions are described in the following table, together with examples showing results 
; produced when these functions are executed. 





General Functions 


) 
| Function and . 


ri Twelve-digit approximation of z. 
SOR Ox 2 Positive square root of x. 

FACT exe Factorial of the positive integer x. 
MABE X Lys Maximum of two values. 
MIMex.y: Minimum of two values. 


MOOGx.y: x reduced modulo y, that is x-y#THT&x-y?. Moose -ii, 3: 
f 
AGO tl 4 So 


RAMDex.y- Remainder of x.y, that is x-y#IFtx-y>. De Lt a be 
RMOCLi, 3: 
Reduction of x by y, that is x-y#n, where n is the} FEDe-1Li. as. 
nearest integer to x.y. 1 
REQ LL, a2 
=1 


Value of most recently executed expression. = 


oe 

vr 

ce rae 
I 


Sign of x. Returns 1 if the argument is positive, 0 if it is 
0, and —1 if it is negative. 
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Logarithmic Functions (LGT, LOG, ExF, EAPOHEHT, LOGRI, EXFM1) 


These logarithmic functions are described in the following table, together with examples showing re- 
sults produced when these functions are executed. 


Logarithmic Functions 


Function and | : : 


el ee logis x. The common logarithm of a positive x 
or LOG Lex: (base 10). 

LOGexs In x. The natural logarithm of a positive x (base e). 
or LHexs 


EPOX: e*. The natural antilogarithm. 


EXPOMENT &x2 | The exponent of normalized x. 

LOGRF Lex: Inditx) (LOG. +x2). LOGPIitCl, 2¢s456-18> 
Useful for accurate evaluation of LIIi«x: for x 1, 2a24455959992E-16 
very close to 1. 

ESPMICx: e—1 (ExFtxs-1). Useful for accurate evalu- 
ation of EXF «<x >for x very close to 0. 





Hyperbolic functions, inverse hyperbolic functions, and certain financial calculations involve the 
expressions In(1 + x) and (e*) — 1 for arguments near zero. To allow greater accuracy in such calcula- 
tions, LOGFi and EXF M1 evaluate these expressions directly. 


Angular Settings (FAQ TAHS, DEGREES) 


After memory reset, the HP-71 assumes angles are measured in degrees. If you wish radians to be the 
unit of measure for expressing angles, execute in BASIC mode FAQIANS (or 
OF TION AHGLE FACQIAWS). If you wish degrees to be the unit of measure, execute DEGREES (or 
OF TION AWHGLE OEGEEES). Note that these statements do not convert arguments from one unit of 
measure to the other. Such a conversion is done by the functions DEG and FAQ, described below. 
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Trigonometric Functions (21H, COS, TAH, ASIHW, ACOS, ATA, DEG, RAO, 
AHGLE) 
The HP-71 provides 9 predefined trigonometric functions. It’s important to keep in mind the range of 


values that the inverse functions (arc sine, arc cosine, and arc tangent) return, which lie in Quadrants I 
through IV. Assuming radians is the angular setting, the HP-71 represents angles as follows: 





y —axis 
att 
2 
Quadrant Il Quadrant | 
T T 
5 <O<r Oo<a< 
O x-axis 
Quadrant Ill Quadrant IV 
T T 
ToO< 5 > <A<0 
este 
2 
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Trigonometric Functions 


Function and Meanin Example with Result 
Argument g (Radians Setting) 


Sine of x. 


Cosine of x. 


TAH Ex: Tangent of x. 


ASIN¢x3 Arc sine of x, where —1 < x < 1. In Quadrant | or IV. 
or HeHcx: 


Arc cosine of x, where —1 < x < 1. In Quadrant | or Il. 
Or HOStx: 
ATAH © x2 Arc tangent of x. In Quadrant | or IV. 
or ATHEX:? 
DEGixs Radians to degrees conversion. 


RAD Xs Degrees to radians conversion. 


HHGLE*x.ya Arc tangent of y/x, in “proper” quadrant; that is, the angle 
between (x,y) and the positive x-axis. 





There is an important difference between the AHMGLE and ATAN functions. AHGLE takes two ar- 
guments to find the arc tangent of their quotient in the proper quadrant. ATAH returns the principal 
value of the arc tangent—that is, the value in Quadrant I or IV—of a single argument. For example, 
AMGLEC-3,-2°9 returns ~-146, 389932474 degrees (in Quadrant III), whereas HTAH&-2--3 3 
returns 22,6398867526 degrees (in Quadrant I). 


Random Numbers (EHO, FAHOOMI=ZE) 


The FH function (which takes no argument) generates the next number R in a sequence of pseudo- 
random numbers such that 0 < R < 1. Each time F'HEf is evaluated, it returns a new random number. 
The starting number of a random number sequence determines the sequence of values that F HO will 
return. 


RAMON TSAE [numeric expression] 
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To set the starting number for the random number generator, either: 


e Execute FAHCCMIZE alone, which causes the HP-71 to generate the starting number, based on 
the current HP-71 clock reading. 


e Specify any constant or expression within the range of the HP-71 in a RANCH IZE statement, 
which causes the HP-71 to start the sequence based on the value of that expression. (Specifying a 
numeric expression of zero causes a constant sequence of zeros). 

| For instance, executing FANDOMIZE 423, then executing RHO, returns , 629225858722. After a 

; Memory reset, if you repeatedly execute F'H[I before executing FAHDOMI2E, the HP-71 will generate a 

| specific sequence of numbers, starting with . 5251932352623. So if you want a different series of 

- numbers, execute FAHOCHMIZE before RHO. 





Use the following formula to generate random integers, i, iz,..., l;,..., such that 5 < i; < L, where 3 
and L represent any two real numbers. 


Lj = [TFercbL+i-Si:tRPHoes3 


Example: To illustrate the rule given above, enter a FH[ expression that will return a random num- 
ber in the range 1 to 100 inclusive. 


Input/Result 
IFC i SBeRHO+1 & 


This is the first number returned after a memory 
reset, and before FAHOOMISE has been ex- 
ecuted. (After a memory reset, the HP-71 is in 
BASIC mode). 





Good statistical properties can be expected from the random number generator if a statistically signifi- 
cant sample size is considered.* 


*The HP-71 random number generator passes the Spectral Test. Donald E. Knuth, The Art of Computer Programming (Massachu- 
setts, 1969),vol.2,section 3.4. 
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Number Formatting 


Numbers are always stored in the HP-71 to 12 digits, but you can display numbers in any one of four 
formats: =TO, Flvd, SCId, and EHGd. The parameter d specifies the number of fractional digits 
(F Id) or one less than the number of significant digits ([C Id, EHGd). The results of 188-2 dis- 


played in each format are: 


|. 


‘mma 


o TD: 
PIA 
SO] 
EMG 


af 


El, 


/ 
mA 


A 


pane 
‘saute 
— 
woods 


Fl 


Fl 

: iy 
Ty 7 
hs De 


[1,2 fv Pt 


=, 
mie 


Each of these number formats is described in more detail below, following the discussion of exponential 


notation. 


Exponential Notation (E) 


Exponential, or scientific, notation is a short-hand system to express numbers too large or too small to 
fit the display normally—that is, numbers that can’t be expressed adequately with 12 digits. The 


number 
— .00000000000123456789012 


expressed in exponential notation is: 


Single digit From Oto 11 
to the left digits to the 
of decimal point. right of decimal 
a point. 
a 
mi, BE4R67SSG15£ 
Negative sign” 
(If number is 
less than 0). Decimal The symbol =, 
point. indicating a 
power of 10. 


Two or three 
digits for the 
exponent 


Negative sign 
(if number is 
a fraction). 


Exponential representations have two parts: the base part, which consists of significant digits, and the 


exponent, which consists of an integer power of ten. 


You can enter numbers in any form. However, the HP-71 will display a number in exponential notation 
only when it’s required by the number format in use, as the following examples show. 
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Example: Execute F 12 in BASIC mode. 


Input/Result 
LEl2-i18e8 


In FI #2 format, this number is displayed with- 
out exponential notation, since it’s less than 1012. 





LE i2+1886 [END LINE 


Numbers whose magnitude exceeds 1 x 1012 — 1 
are always displayed in exponential notation. 





Standard Display Format (TL) 


In standard display format, numbers are displayed with the smallest number of digits consistent with 
presenting maximum accuracy. The result of i. is displayed as .5, while 1.2 is displayed as 
.3332323323333. Numbers too large or too small to be viewed with maximum accuracy without 


exponents are displayed in exponential notation. 


Fixed-Decimal Display Format (F Is) 
FIs # digits 


In fixed-decimal display format, numbers are displayed rounded to the specified number of digits 

_ (# digits) past the decimal point. The range of values for # digits is & through i 1. Numbers too large 
or too small to be viewed in the current fixed format are displayed in scientific format. In F1™2 
display format, the result of 1.°z is displayed as 4, 33. 


Scientific Display Format (2° T) 





SUI # digits 





In scientific display format, numbers are displayed with an exponent. The base part shows the speci- 
fied number of digits (# digits) past the decimal point, while the exponent shows as few digits as the 
number permits. The range of values for # digits is & through 11. In SC 12 display format, the result 
of i. 3 is displayed as 2. Z%E-1. 
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Engineering Display Format (EH!) 


EMG # digits 


In engineering display format, numbers are displayed as they are in scientific format, except exponents 
are shown in multiples of three, and the specified number of digits (# digits) refers to the number of 
digits to the right of the leading digit. The range of values for # digits is 4 through 11. In EHGE 


— 


display format, the result of 1-3 


—_—=— 
=z +. 


is displayed as 223,E-3. 


Numeric Precision (FT iG REMIN@) 


The HP-71 performs calculations internally using 15 significant digits. The results of these calcula- 
tions are then rounded to 12 digits for storing and display. This rounding can be done in any of four 
round-off settings given by GPTIOGH ROUND: 


e OP TICH FOLHE HEAR rounds to the 12-digit value nearest to the 15-digit internal result of the 
calculation, and in case of a tie, it rounds to the value with the even last digit. 
CPTIOCGH FOUND NEAR is in effect after a memory reset. Entered FEAL numbers (page 57) over 
12 digits long always round according to OF TIOH ROUND HEAR, regardless of the round-off 
setting in effect. For example, when the 13 digit number 1.234567890125 is entered, the display 
shows 1. 22456729012. The number is not rounded up to show @ as a final digit; rather, 
OF TIGN FOUND HEAR causes rounding to the value with the even last digit (=). 


e OF TICOH ROUHG ZERO rounds towards zero. 

e OPTION FOUND FOS rounds up. 

e CF TION FOUNG HEG rounds down. 
Calculation results stored in variables whose types are SHOFT and FEAL are rounded according to the 
current round-off setting. Results stored in IHMTE‘GEF type variables are rounded to the nearest digit, 


with ties always rounding up in absolute value. REAL, SHORT, and INTEGER precision variables are 
introduced on the next page and also discussed under “Declaring Arrays” in section 3. 


If the current display format causes less than 12 digits to be displayed, the displayed result of a cal- 
culation is always rounded to the nearest displayable value, with ties always rounding up in absolute 
value. 


oe ee a ee ee | eee gee ee ee ee ee eee 


en eee ee eee ee! 
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| Precision of Numeric Variables (#2 FL, SHOET, THTEGE me) 


- Besides declaring the name and value of a numeric variable (section 3), you can declare its precision— 
_ that is, the number of digits used by the HP-71 to store its value. In arrays, the fewer digits used, the 


less memory is used to store variable values. Three types of precision are offered: REAL, SHORT, and 
IHTEGEF. 


e REAL variable values are stored with the full precision of the HP-71. They cover the range of 
values from -NAXREAL through MASREAL. Numbers with REAL precision are represented in- 
ternally by 12 digits and a three-digit exponent. 


e SHUFT variable values cover a slightly narrower range, —9.9999 x 10499 through 9.9999 x 10499, 
Accordingly, SH™FT numbers are represented internally by five digits and a three-digit exponent. 


e IHTEGER variable values lie between —99999 and +99999. IHTEGE numbers are stored with 
five digits and no exponent. 
Math Exceptions (: pL eg LP es Erte) 


During a calculation, various operations can result in unusual results, depending on the values of the 
terms involved. Such exceptions include the square root of a negative number, division by zero, results 


/ too large or too small for the HP-71 to represent, and results that cannot be represented exactly in a 


12-digit, floating-point format. Associated with each math exception is a flag that is set by the HP-71 
whenever an exception is encountered. These flags remain set until you clear them. Each of these flags 
can be accessed by its number or by its name. You can clear and set the math exception flags in the 
same way as any flag, except that flag names can be used as well as flag numbers. 


For more information on flags, refer to section 11. And for information on when math exception flags 


| are set, refer to “IEEE Proposal For Handling Math Exceptions” in the reference manual. 


The following table summarizes these five math exceptions, and subsequent topics in this section dis- 
cuss how you can control the HP-71 responses to such exceptions. 


Math eee 


Invalid operation 


Division by zero 
Overflow 
Underflow 


Inexact result 
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Recovering From Math Exceptions ((QEFAULT OH, DEFAULT OFF, 
DEFAULT EaTEND) 


The HP-71 provides three ways to recover from math exceptions: 


e DEFAULT ON is active after a memory reset. With DEFAULT ON active, the occurrence of a 
division by zero, overflow, or underflow exception causes a warning message, and the calculation 
continues using default values. The occurrence of an invalid exception halts the calculation. 


e With DEFAULT OFF active, when any math exception occurs, except inexact result, an error 
results and the calculation stops. In this case, the OH ERROR statement (page 172) can be used to 
recover from math exceptions. | 

e With DEFAULT EXTEHOD active, the HP-71 supplies a special set of default values for math 
exceptions, which is described beginning on the next page. 


Regardless of the (EFAULT setting, an inexact result is always rounded according to the round-off 
setting in effect (page 56). 


Assuming a DEGREES setting, the DEFAULT ON warning conditions and default values are: 


Default Values Supplied in Response to Math Exceptions 
(DEFALLT OH Active) 


Warning Number 
(ERRN) and Warning Condition Default Value 


Exception (Degrees Setting) 


Underflow; that is, a nonzero result between 
-EPS and +EPS. 
Overflow: 


e For INTEGER variables. +99999 


e For SHORT variables. +9.9929E499 
e For REAL variables. £9 FIFIFIFISISESRIS 


E*PONENT *@) .9999999999SE4S9 


TAN is infinite, caused by an argument equal to +9. 93939999959 3E493 © 


an odd multiple of 90°. 

Zero raised to a negative power. ~99999999999E49S 
Zero raised to a power of zero.* 

Division by zero. .9999g9ggg9g999E4a9 
LN¢a@> .99999999999E499 


*@°68 and INF“@ do not set a math exception flag, but they do halt a calculation with an error if DEFAULT OFF is 
active. 
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The IEEE Proposal for Handling Math Exceptions (+1 nf, -Inm?, IHF, HAH, 
Hal, TRAF, *) 


At the time the design of the HP-71 was completed, the IEEE Computer Society was in the process of 
defining a standard for floating-point arithmetic. The two main aspects of the IEEE proposal that 
pertain to decimal arithmetic are accuracy of arithmetic results and exception handling. The HP-71 
| meets the specifications of the IEEE Radix Independent Floating-Point Proposal, as it existed when 
this design was fixed. 


Associated with each math exception flag is a trap that “traps” a particular exception and specifies a 
particular action to be taken, as summarized in this table. 


Actions Corresponding to Math Exception Trap Values 


Suspend execution with an error message. 








For WHF, OF, and O4'2, supply default 
values shown in the table above. For I4!L, 
Suspend execution with an error message. 
For IH, supply rounded result. 








Supply IEEE default values. 





TRAP is a function that either returns the current trap value or sets a new trap value for a specified 
math exception flag. 


- exception flag # 


TRAP [. new trap value] : 


‘exception name 





_ Examples: 

TRAP COWES, G3 Causes the HP-71 to suspend execution with an 
error message in response to the division-by-zero 
exception. 

TRAP COWS, 13 Causes the HP-71 to supply the default value 


3, 3899999999 9E499 in response to the 
| division-by-zero exception. 
TRAP COWS, 23 Causes the HP-71 to supply the IEEE default 


value Imf or ~In#f in response to the 
division-by-zero exception. 
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This table shows the trap values set by each of the three DEFALILT choices for each of the five math 
exceptions. 
Math Exception Trap Values Set By CEFHLULT Choices 


[ea [ove [ovr [oe [a 
4 E 4 i 


I 





Default 












BEPAGCL EF 
DEFAULT UH 
CEFAULT EXTEMO 





me ee 


The special responses to trap values of = include +Inf (infinity) and 4H (not a number). Irf is the 
TRAF = value supplied for an overflow exception ('F) or a division by zero exception (0'\'2), and 
Mah is the TRAF = value supplied for an invalid operation exception (I'/L). IMF is a no-argument 
function that returns I rf, which behaves like mathematical infinity in subsequent calculations. HAH 
is a no-argument function that returns a signaling Halt, which can be used to initialize any 
uninitialized data so that the I'L flag will be set whenever this data enters into a calculation. The 
“IEEE Proposal For Handling Math Exceptions” section in the reference manual covers the IHF and 
MAH functions and these TE AF =z math exception responses, and also includes a further discussion of 
how the HP-71 meets the provisions of the IEEE Proposal. 


In addition, the reference manual discusses the relational operator *, which returns i (true) when one 
or both of the expressions being compared are unordered; that is, one or both are Hal. 


Categories of Numbers (LH=5 


The inclusion of TRAF = default values for math exceptions extends the normal range and type of 
numbers. This extended range is divided into six classes. Class 3 includes normalized numbers from 
EFS to MAXFEAL inclusive. The other five classes cover zero, denormalized numbers (between zero 
and EFS), infinity, and HaH (quiet and signaling). The {LAS function returns a signed number 
showing the class and sign of the argument. Program control is the main application for CLASS. The 


HP-71 Reference Manual discusses "LAS in more detail. 
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‘Range of Numbers (2 HREESL, EPS) Naseer i.) 


The following diagram shows the range of values that can be entered and stored (the shaded areas 
‘Indicate values that can’t be represented on the HP-71.): 


~MINFEAL MHIHREAL 
: -MAXREAL —0.00000000001E — 499 0.00000000001E — 499 MASE EAL 
- ~9.99999999999E499 ie BHe 9.99999999999E499 
-IHFE | —1.E—499 1.E—499 | IHF 
' ' Y oy +f ' 


Denormalized 
Numbers 






All numeric operands are represented by a sign, a 12-digit base part, and an exponent ranging from 
-~435 through 455 inclusive. Most numbers have a nonzero leading digit. These are called 
‘normalized numbers. For example, the number —1234.56 is displayed in SCIii format as 


~1, 234568888005 3, The smallest normalized number is called EE'% (1. FARR eeaobeae-493), 


The HP-71 displays very small numbers, whose normal exponents are less than — 499, as denormalized 
‘numbers, with one or more leading zeros. For instance, with the trap value (page 59) for the underflow 
flag (page 57) set to = (TRAPCUHF, 23 ), EPS.1866 is displayed in SCIii format as 


8, 8618688808G8E-495, The smallest positive denormalized number is called MIHRERL 


(8, S888 88G881E-4595), Smaller values generally underflow to zero. 


‘Entered numbers or results smaller than the smallest positive normalized number the HP-71 can re- 
present (EF) may produce an underflow condition. Numbers or results larger than the maximum 
positive finite number the HP-71 can represent (HA#REAL) produce an overflow condition. These 
‘conditions either suspend a calculation with error messages or continue the calculation with various 
default values (such as values between EF and H IHFREAL as explained above). These errors and 
‘default values are discussed on pages 57-60 beginning with the topic “Math Exceptions.” 
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Relational operators compare the values of two expressions and return a 1 if the comparison is true, 
and a — if the comparison is false. That is, the relational operators operate on numeric and string 
values to return Boolean values. (Strings are covered in section 3, “Variables: Simple and Array”.) The 
new * relational operator is described in the HP-71 Reference Manual in the section “IEEE Proposal 
For Handling Math Exceptions.” 


Examples of Relational Operators 
nerational Meanin Example(s) with Result(s) 
Operator g P 
* Greater than? 2 
Greater than or equal to? 
Less than? 


Less than or equal to? 


Less than or greater than? 


Not equal to? 


Unordered? 





The equal sign (=) is used in both variable assignment statements and in relational expressions. When- 
ever an entry can be interpreted either way, the HP-71 assumes the entry is a variable assignment. 


Logical Operators (Fil, OR, RAGE, HLT) 


The four logical operators operate on Boolean values to return Boolean values. The logical operators 
interpret all nonzero numeric operands as 1, or true, and operands equal to zero as 0, or false. AHO, 
FE, and EXOF return a value of 1 if the relationship between operands is true and a value of 0 if the 
relationship is false. HCiT, a unary operator, returns the opposite value (0 or 1) of a single operand. 
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Examples with Results 


HHO 4 







Logical Operators 






Logical 
Operator 






Evaluation 


Both expressions true (that is, nonzero)? 









AMD 





dm 4 





Either expression true? 










One or the other expression true—but not both? This is the 
equivalent of ©H AHO HOT B> OF CEB AMO HOT AD. 








Is the expression false (that is, zero)? 


Relational and logical operators may be used to compare numeric constants (= CF fH), variables 


‘(A AHO &), functions (SIH¢A® AHO CoOs¢A>), and larger expressions. 
Example: If h = 0 and & = 20, then: 


 Input/Result 


NOT A RHO «B<oe-B 3 Enters an expression with logical, relational, and 
7 arithmetic operators. 


———— 
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Precedence of Operators 


The list below shows HP-71 operators in their order of precedence, from highest to lowest. 


The operations with higher precedence are performed first. Expressions are evaluated from left to right 
for operators at the same level. 


1. 


ee 


OC MIND M 


Expressions within parentheses. Nested parentheses are evaluated from the inside out. 


Functions, such as =IH, LOG, and FACT. 


Unary ~, logical HtiT. The minus sign in —H is the unary ~ operator, which changes the sign of FA, 
whether FA is positive or negative. 


#, 7, &, DTM, 
+>, 


Relational operators: Combinations of <, =, >, #, and “. 


. Logical AHO. 
. Logical OF, EXOR. 
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Overview 


This section covers: 


e Special features of the HP-71 BASIC language relating to quoted strings, string functions, and 
variables, both numeric and string. 


e Simple variables, numeric and string. 
e Array variables, numeric and string. 


e Manipulation of strings. 
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Features of Variables and Arrays 


The HP-71 BASIC language includes some features that may not be familiar to those who have worked 
with other versions of BASIC. The more important of these are listed here, and page references are 
given for those features discussed later in more detail. 


e Array and string dimension limits can be expressions. 


e VAL and 5TF# evaluate numeric expressions and return the result as a numeric value or a string 
(page 76). 


e Variables are shared between keyboard use and programs (see below). 


e Default variable values (@ or "") are automatically returned without warning when an unassigned 
variable is used from the keyboard or in a program (page 68). 


e Variables can be destroyed and the memory they use reclaimed (page 67). 
e A simple and an array variable cannot share the same name (page 68). 


e The & symbol concatenates statements in one line (page 146). 


e Multiple assignment statements (such as A,&,C€=18) are not allowed. However. one program 
line can assign values to _ several variables using concatenation (for example, 
H=180 @& B=166 @ C=1ib8 @& O=35). 


e LET can be omitted from assignment statements. 
e ISP can be omitted from display statements except after THEH or ELSE (page 226). 
e Both ' and " can be used in DISF and FR INT statements. 


Sharing Variables Between Keyboard and Programs 


e When you run a program, the variables used by that program may contain values assigned to them 
from the keyboard or from a previously run program. 


e Ifyou don’t want your program’s variables to have previously assigned values, you can cancel your 
variables’ assignments using [IESTF’ or, for simple variables only, dimension your variables using 
DIN, REAL, SHORT, or INTEGER. You can use these keywords in your program or from the 
keyboard. To ensure your array variables do not have previously assigned values, you must use 
Uk=TEOY or assign each element a new value. 


Reclaiming Memory (DE STEG': 


The DESTROY statement allows you to recover the memory allocated to a variable, to several 
variables, or to all variables. 


DESTROY variable [, variable...] 
DRSETROY ALL 
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Examples: 

DESTROY C4t,H,R2 The variables 44, lil, and f= no longer exist, the 
user memory previously devoted to them is re- 
leased, and the variable names are available for 
other uses. 

ME STROY ALL All variables are destroyed, and all memory pre- 


viously allocated to them can now be used for 
other purposes. 


Numeric Variables: Simple and Array 


A variable or array can be named with a letter alone or a letter followed by a single numeral, 0 through 
9, Some examples are: A, }/2%, F ?. Simple numeric variables and arrays share the same name choices. 
For instance, if a variable A is assigned a value, say =, the letter AH cannot be used as the name of an 
array. 


A nonexistent variable is one that has neither been assigned a value nor declared to have [HTEGER, 
SHORT, or REAL precision, either in a program or from the keyboard. If an attempt is made to recall 
the value of a nonexistent numeric variable, a zero is returned without a warning or error message or 
beep. However, the variable still does not exist. 


If you attempt to recall an element of a nonexistent array, whose row and column numbers (subscripts) 
are within the BASIC default dimensions (10), a zero is returned without a warning or error message or 
beep. 


If an array reference has a row or column number larger than that given by the array’s dimensions, 
either a Subscript error is given and the program halts (TEAF«IVL, 82 or TRAP ETL, 1a 
active), or a Subscript warning is given, Nati is returned and the program continues 
(TRAP IVL, 22 active). 


Setting the Lower Bound of Arrays (QF TIOCH BASE 


All HP-71 array subscripts begin at 0 or 1, depending on whether OFTIOWN GASE & or 
OF TIOQH BASE 1 is active at the time the array is created. 


DFT IOW 


IFT TOM 
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Once an GF TIOH EASE statement is executed from the keyboard or in a program, it stays active 
until another OF TIOH EASE statement is executed or until a memory reset occurs. Memory reset 
sets WFTIOH BASE &. The argument for the OFTIOH EASE statement can be any numeric 
expression that evaluates to either 0 or 1, but the most common forms for GF TIOH EASE are those 
shown above. 


_ Example: The following program segment illustrates the action of OF TICH EASE 
10 OPTION BASE 0 Any array declared after this statement is 


executed will have 0 (or 0,0) as the lowest 
numbered subscript. 


20 DIM A(5,5) | | Since array A has 6 rows and 6 columns, it has a 
total of 36 elements. 
30 OPTION BASE 1 Any array declared after this statement is 


executed will have 1 (or 1,1) as the lowest 
numbered subscript. 


40 DIM B(5,5) Since array B has 5 rows and 5 columns, it has a 
total of 25 elements. 


The execution of line 30 does not affect the lower bound of array fi. It still has 36 elements. 


Declaring Arrays (CIM, FEAL, SHORT, [IHTEGER) 


An array declaration not only defines the highest numbered subscript(s) of the array, but it also defines 
the precision of the array’s elements. If the array did not previously exist, an array declaration also 
initializes all elements to zero. [IM and FEAL both declare FERAL. precision numeric variables. How- 
ever, only {iI M can declare string variables, as described on page 72. 


simplified syntax 


CIM variable list 









simplified syntax 


REAL. variable list 
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simplified syntax 






=~Hiurk T variable list 


simplified syntax 


IHTEGE® variable list 


Examples: These examples assume the arrays do not already exist. 


ead) eo St aed oe Both arrays have real precision. Assuming 
MFTIOH BASE i is active, array A has five 
elements, and array = has 225 elements. All 
elements in each array are initialized to zero. 


THTECER Cacr,18o Assuming SF TICH BASE & is active, array 02 
has IHMTEGEF precision and 88 elements, all 


initialized to zero. The lowest numbered element 
is (0,0). 


Default Array Dimensions: (10) or (10,10). The HP-71 assigns dimensions (10) or (10,10) to a 
nonexistent array when an assignment statement stores a value into a nonexistent element. If one 
index of this element is beyond 10, an error occurs. All other elements are assigned the value zero. Each 
element has real precision. 


Examples: The array in each of the following examples has not been dimensioned. 
MPTIGWN BASE & 1s set. 


«weg vomy ooeny eeeey 


we PB Since neither of the indices «7, 2" is greater 
than 10, the array is dimensioned (10,10) and is 
given 121 elements. Element *. = is assigned the 
real value '!, and all other elements are assigned 


the value zero. 


Noid psd Since the array element in this assignment state- 
ment has an index greater than 10, no array is 
created, and no value is stored. 


Changing Array Dimensions Under Program Control. The HP-71 can redimension an array 
during program execution. This allows you to design a program whose arrays automatically change size 
to accomodate changing amounts of data. Redimensioning is done with any of the same four statements 
that declare initial dimensions: DIM, REAL, SHORT and IHTEGER. 


Note: When redimensioning an array, declare the same precision that the array currently has. 
Otnerwise, all array values will be lost. 
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If an array’s dimensions are reduced, some elements will of course be lost. Otherwise, existing elements 
remain intact, although they will probably appear to have been rearranged. Array element values are 
stored row-by-row. That is, the first row, last column value is followed by the second row, first column 
value. If an array’s dimensions are expanded, all new elements are initialized to zero. 


Example: Array A is declared as DIM 2,22, and contains values 1 through 3 arranged as shown. 


Array A 


Column Column Column 
1 2 3 





After CIM Ae3, 253 is executed, the array’s values are rearranged as shown: 


Column Column 
1 2 





The additional element A(5,2) is assigned the value zero. 


Strings 


A string can be a quoted collection of characters, or a variable or expression representing such a collec- 
tion of characters. The HP-71 supports one-dimensional string arrays and offers a powerful set of 
string functions. These are all discussed below. 
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Quoted Strings 


Quoted strings can be enclosed by a pair of single or double quotation marks, as shown in the following 
example. A quoted item must be enclosed by a pair of single or double quotes; the quote symbols cannot 
be intermixed. 


PRIHT '"Paradise Lost” was written bu John Milton, ' 


When a file name is used as a parameter in a BASIC statement, quotes can be omitted. 


String Variables: Simple and Array (CiIM, GP TIGH BASE) 


String variable names consist of a letter, an optional numeral, and a dollar sign. Some examples: Ai#, 
C44 and i? #. A simple string variable and a string array cannot share the same name. 


Default Value—The Null String ("'"). The null string, represented by "" or ' ', is the value re- 
turned for a reference to a nonexistent string variable. It is also the value given to a string variable 
when it is first created. The null string contains no characters, and can’t be printed or displayed. 


Declaring Dimensions (TIM, GPF TIGH BASE). The [IM statement is used to declare, in square 
brackets, the greatest number of characters (including spaces) a string variable can represent. [IM is 
also used to declare, in parentheses, the highest numbered element in a string array. [11 initializes all 
string variables to the null string, except for previously dimensioned string arrays. 


CF TIOGH GASE not only sets the lower bound of numeric arrays, but of string arrays as well. 


Only one-dimensional string arrays are allowed. 


simplified syntax 





cil ft variable list 


Examples: 

DIN ASSéC25] Dimensions a simple string variable to have a 
maximum length of 25 characters. 

DIM Cé€¢155C4a Assuming (FTIOH EASE 1 is active, declares 


a string array to have 15 elements, each with a 
40 character maximum length. Each element is 
assigned the null string. 
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Default Dimensions. If a string variable’s length is not declared with [1 1', the HP-71 sets its maxi- 
mum length to 32 characters. OF TIQH EASE has no effect on string length or position. 


If a string array’s dimension is not declared with [11 ! before its use in an assignment statement, the 
array’s dimension is automatically set to 10. The number of elements in such an automatically 
dimensioned string array will be 10 or 11, corresponding to GFTIOH BASE 1. or 
MPTIOM BASE &. 


Example: (FPF TIGH EASE & is set when this statement is executed. 


DIM Fate 4s String array F3# has 5 elements, and the maxi- 
mum length of each element is 32 characters. 


Changing Array Dimensions Under Program Control. [iI!i can also be used to change the 
dimensions of an existing string array. For the original string values to remain unaltered, the maximum 
string length for each element must remain unchanged. If the string length dimension of the 
redimensioned array is changed, all elements become null strings. If the redimensioned array has fewer 
elements, some string values will be lost. If the redimensioned array has more elements, the additional 
elements will be initialized to the null string. 


Example: Assume UF TIGH EASE & is in effect. 


CIM Weck > This statement changes the dimension of arrary 
li# to the current value of the variable F'. Since 
no string length is specified, the maximum string 
length becomes 32 characters. 


String Concatenation (::) 


Two or more string variables or quoted strings, in any combination, can be joined together to form a 
new single string using the concatenation operator %:. 


Substrings 


A substring is a portion of a quoted string or string variable made up of one or more adjacent char- 
acters. T'he null string can also be a substring. 


Specifying Substrings. A substring is specified by a subscript or subscripts enclosed within square 
brackets following the string. 


Examples: 

Af="LARM" CRI Assigns to A the substring from the third 
through the last character. 

BS=TEL4, 99 Assigns to E = the fourth through the ninth char- 


acters of T#. 
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Assigning Values to Substrings. You can assign any string expression directly to a substring of a 
variable. 


Examples: 

NEC SoC Post Assigns = to the fifth element of array [i start- 
ing at position seven. Any characters that pre- 
viously existed, starting at position seven, are 
deleted from M#«52. If this M# element 
originally had fewer than seven characters, say 
four, three blanks would be inserted between the 
original fifth element and the start of =. 


WEL], Jd="teacup"” This statement expands or contracts the part of 
\'# from positions numbered I through -! so 
that "teacup" will fit into it exactly. Any char- 
acters that previously existed from I through .! 
are deleted, including the characters at positions 
I and uJ. 


String Functions (LEH, FOS, VAL, STRE#, HUM, CHES, UPEC#) 


The HP-71 BASIC language includes a flexible set of string functions that allows you to create, analyze 
and manipulate strings. The following four numeric functions analyze strings, returning a numeric 
result: 


Numeric Functions 


LEH « string: Returns the number of characters in a string. 


Fis <string 1, string 2 Returns the position of string 2 in string 1. The optional numeric expres- 
[. numeric expression] : sion specifies the search start position. 


WAL « string} Evaluates the string as if it were a numeric expression and returns the 
value of that expression. 


HU « string > Returns the character code of the first character in the string. 
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The following three string functions return a string result: 


String Functions 


= TR" numeric expression: | Evaluates the numeric expression and returns the result as a string. 


CHE «numeric expression: | Returns the character whose character code equals the value of 
numeric expression. 


UF RIC # « string > Converts all lowercase letters in the string to uppercase letters. 





Substring Position (F035). This two- or three-argument function returns the position of a substring 
within a string. The first argument specifies the string being searched, while the substring is specified 
by the second argument. An optional third argument specifies the character position where the search 
is to begin. 


If the second string is not contained within the first string, the value returned by the function is zero. 
Without the optional third argument, only the first occurrence of the substring is given by Fils. 


Input/Result 

POS¢"CHICRGO", "GO" Returns &, the starting position of "GO" within 
"THICAGO", 

FOSe "CHICAGO". "STOR" Returns 4, since the substring does not occur in 


the string being searched. 


A¢="JAIL"@ BS="AIL" (ENDLUNE] 


POSCAS, BE2 Returns =, showing that "HIL" begins at posi- 
tion two in "JAIL" 

POS" TENHESSEE "| “E's 32 Returns 5, the first E whose position number is = 
or higher. 


, The first E is ignored, since its position number is lower than 2. The function begins its character-by- 
| character comparison with the character (}) located at position 3. This comparison continues to posi- 
| tion five, where a match is found. The function then returns %, the position of the first E whose 
position number is three or higher. 
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String-to-Numeric Conversion (!/fiL). This function converts a string expression containing a 
valid numeric expression into a numeric value. The numeric expression can include variables, functions, 
and operators. Note that \}AL evaluates a string expression as though it were a numeric expression. 


In summary, '! HL evaluates the following as though they were numeric expressions: 
¢ Quoted strings of characters, such as "473" or "MH#¥23". 


e The characters represented by string expressions, such as H# or B¥2. "2 "2004. 


Any characters following the first valid numeric expression are ignored. If the first character in the 
string cannot be interpreted as part of a numeric expression, an error results. 


Input/Result 
CE="FACT(6239°0,5"@8F] 42 


WAL <i [END LINE Returns %.61E42. Since (# represents a valid 
numeric expression, \f/AL “#2 evaluates the 
expression and returns its result. 


Example: An example of the '|Ail. function’s power is the following program to compute the integral, 
using the trapezoidal rule, of an arbitrary function you enter from the keyboard. (Execute 
ECIT TREAPINT to open a file for this program, then enter it and try it out.) 


10 ! Trapezoidal rule integration 
20 DIM F$[90],L,U,X,T,S,| 
30 INTEGER N 


40 INPUT “f(X)=”";F$ The expression you enter here must use * as the 
variable of integration. 


50 INPUT “Lower limit=”;L 
60 INPUT “Upper limit=”";U 
70 INPUT “Number of trapezoids=";N 


80 X=L @ T=VAL(F$)/2 Evaluate at lower limit. 

90 S=(U-L)/N 

100 FOR I=1 TO N-1 

110 X=L+I*S @ T=T+ VAL(F$) Evaluate at points in middle. 
120 NEXT | 

130 X=U @ T=T+ VAL(F$)/2 Evaluate at end point. 

140 |=T*S 


150 DISP “Integral:”:I 


When you run this program, lines 80, 110 and 130 evaluate the function that you entered at line 40. 
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After keying in this program, execute FI =, then press [RUN]. When the f«»2= display prompts 
you for your function, enter 2+. Note that your function must use * as the independent variable. 
Next respond to the other prompts by entering 1 as the lower limit, 5 as the upper limit, and 1 as the 


number of trapezoids the program will use to approximate the integral. You will then see 


This approximates the true integral of 531. 





Increasing the number of trapezoids makes the integral more accurate, but increases calculation time. 


Numeric-to-String Conversions (TF #). This function evaluates a numeric expression and con- 
verts the result into a string, according to the current display format. 


Input/Result 
STREC 2 +667 3 


2 TE first evaluated 2 +6. 7, then converted it 
to a string (shown in FI #2 display format). 
The string =. cannot be used in calculations. 





Converting a Character to Its Character Code (NUM). Your HP-71 uses a set of 256 characters. 
The factory-defined set is shown in your reference manual. Each character has its own character code 
(0 through 255). Ninety-five characters (character codes 32 through 126) are standard printable charac- 
ters as defined by the American Standard Code for Information Interchange (ASCII). NUM returns the 
character code as a numeric value (not a string) for the first character of its string argument. 


Converting a Character Code to Its Character (CHR#). This is the inverse of HUM. It converts a 
character code to its corresponding character. CHR# accepts any arithmetic expression as its argument, 
and, if needed, subtracts or adds a multiple of 256 to the rounded result to get a number in the range 
0-255. It then converts that number to the corresponding ASCII character. Thus, CHR#¢6663 re- 
turns %, because MOD¢64G,256) returns 88, the code for %. 


Relational Operators («, =, >, #,7) 


These operate on string variables as well as on numeric variables. The HP-71 makes string variable 
comparisons using the character code for each string character. For instance, if A$="A" and 
B$="B" , the expression A#>B# returns 4 (false), since the code for A (65) is not larger than the code 
for B (66). For similar reasons, all of the following are true: "A" <"AB" _ AY’ <"A" "ABC"<"B", 
and "234" <"?7". Note that the equals sign (=) can be used in both variable assignment statements 
and in relational expressions. The HP-71 interprets an entry involving the equals sign as an assign- 
ment statement wherever possible. 
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Statistical Functions 
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Overview 


This section covers: 
e The use of the HP-71 statistical statements and functions in a linear regression example. 
e How data can be fit to a straight line model. 


e The use of these statements and functions, together with suitable transformations, in exponential, 
logarithmic and power curve examples. 


A special one-dimensional array is used to store the data (the point coordinates) to be used for statisti- 
cal calculations. TAT creates and dimensions this array, and CLSTAT clears the data previously 
stored in a statistical array. 
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This statement dimensions a one-dimensional statistical array to the appropriate size for a specified 
number of up to 15 variables. The array name can be any standard numeric variable name. STAT can 
also select a previously dimensioned statistical array to be the current statistical array. The # variables 
is optional only if = TAT selects a previously dimensioned statistical array. The array dimensioned by 
STAT has base option zero regardless of the GF TIOH EASE currently in force. All numbers are 
stored with FEAL precision. 





This statement clears (sets to zero) all elements of the currently specified statistical array. 


Using the Statistical Operations 


Example: The following table lists the consumer price index change (CPI), the producer price index 
change (PPI), and the unemployment rate (UR), all in percentages, for the United States over a 12- 
year period. 


The goal is to enter the CPI, PPI and UR data into the HP-71 and to calculate some simple statistics. 
To get the results in the form shown in the following pages, use F I= display format. 


Data for Statistical Example 
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Your first step is to declare a statistical array in which to accumulate the data’s summary statistics. 
Note that this one-dimensional array will not store the entered data, but only the summary statistics 
that are updated each time data is added or dropped. Since you wish to accumulate summary statistics 
for three variables (CPI, PPI and UI): 


Input/Result 

STAT -S¢30 Creates and dimensions a statistical array = for 3 
variables. 

CLSTAT Clears array 5. 

If another array = already existed, STAT =*2% would only redimension array =, and the array 


elements could contain unexpected data. To be safe, clear an array (with CLSTAT) after declaring it, 
unless you wish to use the previous array’s data. 


Adding Data Points to Arrays (HUD) 


ACiC [coordinate value 1 [. coordinate value 2 [...[. coordinate value 15]...]]] 





This statement adds a data point, consisting of up to 15 matched coordinate values—numbered from 7 
to 15 (one for each variable)—to the current data set represented by the current statistical array. 


Example (continued): On a two-dimensional plot, a point is often defined in terms of its x, y coordi- 
nates. Similarly, the data point for 1968 is defined in terms of the three coordinates of that data point, 
CPI, PPI, and UR. You will accumulate in your array the summary statistics for the 12 data points, 
corresponding to the 12 years 1968 through 1979. You enter the first nine data points as follows: 


Input/Result 

ADO 4.2,2,5,3.6 Data point for 1968. 
AGO 5.4,3,.9,3,.5 Data point for 1969. 
AOD 5.9,3.7,4.3 Data point for 1970. 
AOO 4,3,3,.3,5.3 Data point for 1971. 
AOD 323 455506 Data point for 1972. 
ADO 6.2,13.1,4.3 Data point for 1973. 
HOO 11,18.9,5.6 Data point for 1974. 
HDG Sd e se | Data point for 1975. 
ADO 5,.8,4.8,7.°7 Data point for 1976. 


Here you realize you made a mistake; the 4. = should have been 4.6. To correct the error, use DROP. 
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Deleting Data Points from Arrays (DE OF) 


The C.FCF statement is used to delete data points from the array. You’ll see how to execute this state- 
ment, and, alternatively, how the HP-71 Command Stack can be employed to make the correction even 
easier. 


Note: Use only one of the following two methods for correcting data points when working through 
this example. Otherwise, your results won’t match those shown in the example. 


Method One: Using DFUF to Delete Data Points. 


LikF [coordinate value 7 [. coordinate value 2 [...[. coordinate value 15]...]]] 





This statement deletes (drops) a data point, consisting of up to 15 matched coordinate values, numbered 
1 to 15, from the summary statistics maintained in the current statistical array. 


Example (continued): You proceed as follows to correct your error: 


Input/Result 

OROPF S.,6,4,8,7.7 Removes the incorrect data point from the sum- 
mary statistics. 

AO0 5,.8,4.6,7.7 Enters correct data point for 1976. 


Method Two: Using the Command Stack to Change Data Points. Alternatively, by editing an 
HOO statement with the Command Stack active, an incorrect data point can be removed from the 
current statistical array and the correct data point can be added. 


Example (continued): Here’s the procedure for correcting your error using the Command Stack. 


Input/Result 
(g][CMpDs ] Activates the Command Stack. 


The Command Stack displays the most recent 
command,* ready for editing. 





OR OF Replaces ADC with OFOP. 


“OROPS, a, ¢ 





* This keystroke sequence assumes the error has not been corrected. 
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Deletes the incorrect data point from the array 
and deactivates the Command Stack. 


[g}L[CMDs } Activates the Command Stack again. 


SOROPS., 2.4.5, 7.07 The Command Stack displays your DFOF 
statement. 





Display the earlier command. 





Press 10 times. Positions the Replace cursor at the incorrect 
numeral. 





& [END LINE Corrects the error. 


Now enter the rest of your data points: 


ADO 6.5.6.1, 7 Data point for 1977. 
AOU or ber eye Data point for 1978. 
AOD 17 ¢ oes Seo Se Data point for 1979. 


Summing Data Points (7 OT HL) 


The TCITAL function sums one coordinate’s values (one variable’s values) for all data points. For in- 
stance, if each of your data points had two coordinates (variables), say x and y, you would use TOTAL 
to sum all the x values and then use TCITHL again to sum all the y values. 


TOTAL [variable #2] 





This function returns the total of the coordinate or variable values for the specified variable # in the 
current statistical array. If the optional variable # is omitted, the function returns the total of the 
values for the first variable (or “variable #1”). If & is specified for variable #, TA TAL returns the num- 
ber of data points in the array. 
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Example (continued): Using TOTAL, display the sample totals for variable #1 (CPI), variable #2 
(PPI), and variable #3 (UR). 


Input/Result 

TOTAL © &3 Displays 12.4, the total number of samples. 
TOTALS 13 Displays 4.24, the total of the CPI values. 
TOTAL C23 Displays 36.34, the total of the PPI values. 
TOTALS 33 Displays 63.48, the total of the UR values. 


Calculating Means (MERAH) 


MEAH [“ variable #2] 





This function returns the mean of the values for the specified variable # in the current statistical array. 
The default value for variable # is 1. 


Example (continued): You use MEAH in this example as follows: 


Input/Result 

MEANS 1 3 Displays &. 72, the mean of the CPI values. 
MERAH © 23 Displays 3. &5, the mean of the PPI values. 
MEA ¢ 3 Displays =. 75, the mean of the UR values. 


Calculating Standard Deviations (20E'.) 


SDEW [variable #:] 





This function returns the sample standard deviation of the coordinate or variable values for the speci- 
fied variable # in the current statistical array. The default value for variable # is variable #1. 
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Example (continued): Use 30!) to calculate your sample standard deviations. 


Input/Result 

29 8) Sar ee Displays =. &1, the standard deviation of the CPI 
values. 

SOEVC 23 Displays 3, 25, the standard deviation of the PPI 
values. 

SOEWS 33 Displays i . 4%, the standard deviation of the UR 
values. 


Calculating Sample Correlations (0 OFF) 


CORE (variable #1.variable #2: 





This function returns the sample correlation of the values for the two specified variables (variable #1 
and variable #2) in the current statistical array. 


A correlation involving a constant is undefined. If you tried CORF«&,1%, for instance, you’d hear a 
beep and see Invalid Stat Of. 


Example (continued): Determine the three sample correlations among CPI, PPI, and UR. 


Input/Result 

CORR CL, 22 Displays #. 2&, the correlation between CPI and 
PPI values. 

PORE C1, 23 Displays 4.23, the correlation between CPI and 
UR values. 

CORR G2, 3% Displays &. 14, the correlation between PPI and 
UR values. 


Fitting a Linear Regression Model (LF) 


LE variable #1, variable #2 [. variable [, variable]| 





This statement specifies the current linear regression model. You specify the dependent variable as 
variable #1 and the independent variable as variable #2. The LF statement then computes the inter- 
cept and slope for that model. If you supply the first optional variable (any valid variable name is 
acceptable), the HP-71 stores the intercept in that variable. If you supply the second optional variable, 
the HP-71 stores the slope in that variable. 
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The calculation of predicted values (using FFELI\/, explained below) does not use these two optional 
variables. Their use simplifies the recovery of the model’s slope and intercept. If these optional 
variables are not used, slope and intercept can be recovered as follows, since FFED 4 recalculates slope 
and intercept each time it’s executed. 


PREC £ & > returns the intercept, a. 
FREGWc i> - FREQOGc¢&> returns the slope, b. 


You can fit a straight line by the method of least squares to any pair of variables by using the LF 
statement. The only restriction is that the independent variable not have a sample standard deviation 
of zero. 


Example (continued): Suppose you wish to fit a straight line between the consumer price index 
change (variable #1) and the producer price index change (variable #2), where the CPI is the dependent 
variable and the PPI is the independent variable. That is, you wish to fit the line 


CPI =a+ b+ PPI 


to the data, determining values for the parameters a (intercept) and b (slope). Since the independent 
variable, PPI, does not have a standard deviation of zero (you determined above that 
SOEWASs = 3,55), you can use the LF statement. Use two optional variables, H and &, as ar- 
guments three and four, which will hold the values for the parameters a and b. 


Input/Result 
LE 1,2,A.,6 Determines the best-fit straight line for the 12 
3 (PPI,CPI) points, and stores the intercept in A 
and the slope in &£. 
A Displays the intercept 2.61. 
B Displays the slope 4. 24%. 


Calculating Predicted Values (F FE‘) 


PRE « argument 3 





This function returns the predicted value of the dependent variable based on the current linear regres- 
sion model and the value of the independent variable specified as the argument. You must execute |. to 
specify the dependent and independent variables before executing FRED 4, 
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Example (continued): Now predict CPI values for PPI values of 4, 5, 6 and 7. 


Input/Result 

FREOW ¢ 4% Displays 5.16, the predicted CPI value for 
PPI = 4. 

PREGW ¢ 3% Displays = .i4, the predicted CPI value for 
PPI = 5. 

FRED ¢ 63 Displays 5.23, the predicted CPI value for 
PPI = 6. 

FREDDY oF 3 Displays & . 22, the predicted CPI value for 
PPI = 7. 


Fitting Sample Values to Other Curves 


Using suitable transformations, exponential, logarithmic, and power curves can be fitted to data in the 
standard linear regression form 


y=act Ox. 
The following table gives these transformations. 


Transformations to Linear Regression Form 


Name of Untransformed Transformed 
Curve Equation Equation 


Linear y=at+bxx ip a X y=at+bxx 
In(y) In(a) x In(y) = In(a) + Bb x x 
y a Inx) | y=act b x In{x) 
In(y) In(a) In(x) | In(y) = In(a) + b x In(x) 


Example: Suppose the following values for x and y, obtained during an experiment, have been given to 
you for analysis. You plan to determine how well each of the four curves-linear, exponential, logarith- 


mic, or power-fit the data. 
Data for Transformation Example 


A 1.3 47 9.0 17.9 24.4 


16.69 13.51 7.498 3.662 .7170 3271 




















y =a x ex) 
(a>0Q) 


y=a+b x Inx) 


Exponential 









| Logarithmic 





=a x x) 
(a > 0) 


Power 
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To facilitate entering data into a statistical array, arrange it in the following table, with each sample 
column labeled by name and number. 


Rearranged Data for Transformation Example 


Variable # 
2 3 


Variable 
In(x) y 


Observation Variable Value 


-2.303 16.69 2.815 
2624 13.51 2.603 
1.548 7.498 2.015 
2.197 3.662 1.298 
2.885 7170 —.3327 
3.195 3271 —1.117 





Now create and dimension your statistical array and enter your data: 


Input/Result 

STAT Et4> Dimensions a new array. (This statement would 
select and dimension array E if it already 
existed). 

CLSTAT This would clear array E if it already existed. 
While this step is not necessary in many cases, 
it’s a good habit to develop to ensure against new 
data being intermingled with old data in the 
same array. 

AOD .1,7-2.3893,16.69,2.815 Enters the first observation. 

HDD 1.3, .2624,13,.51,2.683 Enters the second observation. 

ADO 4.7,1,546,7.498,2,815 Enters the third observation. 

ACO 3.2,1397,3,662,1,298 Enters the fourth observation. 

ADD 17.3,2,.885, .7?1if,-.3327 Enters the fifth observation. 

AOD 244301 9Sen Seria =. Enters the sixth observation. 
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Determine the appropriate correlations to see if any of the models can be excluded from further consid- 
eration. Execute the correlation functions shown below and see the indicated results. The arguments of 
the correlation functions are the variable numbers from the table immediately above. The transforma- 
tion table on page 86 shows what variables to correlate for each type of curve. 


For instance, the transformation to fit a logarithmic curve in linear regression form uses (from the 
table on page 86) In(x) for x and y for y. The next table (page 87) shows In(x) is variable 2 and y is 
variable 3. So the appropriate correlation function in this example for a logarithmic curve in linear 
regression (straight line) form is CORE C2, 32. 

For the exponential, logarithmic, and power curves, you’re checking to see how well the transformed 
data fits a straight line. If one or more of these curves has a reasonably high correlation, you might 
then use the FFEL function to predict dependent variable values (y or In(y)), given independent 
variable values (x or In(x)). The last step would then be to transform In(y) values back to y values using 
the EF function. 


Correlations Resulting From Transformation Example 


Correlation 


























Linear COREG 1 4-32 Be 
Exponential CORR CL, 42 -1. 86 
Logarithmic CORR Gees. ~H, Se 
Power CORR C2, 42 -H, o4 





None of the correlations is very low. Note that all the transformed curves (straight lines) have negative 
slopes, as shown by their negative correlations. 


You decide to model the data with the curve having the highest correlation, the exponential curve. 
You'll first use the LF statement to specify the linear regression model (“best fit” straight line) cor- 
responding to the transformed exponential curve data. Once that model is established, you’ll be able to 
use the FFE! function to predict some additional In(y) values, as well as to check on several In(y) 
values transformed from the original data. 


Input/Result 


LE 4,1,A,6 Specifies a linear regression model with In(y) 
(variable #4) as the dependent variable and x 
(variable #1) as the independent variable. The 
intercept will be stored in A and the slope in &. 


A Displays the intercept 2. 24. 
BE Displays the slope -. 17. 
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Now you’re ready to predict some values. You want to predict In(y) values for the following x-values: 
—10, —5, 0, 20, and 30. For x = 0, the predicted In(y) value should equal the intercept A. Finally, you’ll 
transform In(y) values back to y-values. As a check, you also want to use some x-values equal to the 
data values you were given, and see how close the predicted y-values come to the corresponding data y- 
values. 


Input/Result 

PREQW¢-1e 4 Displays +.45, the predicted In(y) value for 
x= 1a. 

ESP CORES > Displays the result of e445, where 4.45 is the pre- 


dicted In(y) value just obtained. 


This is the predicted y-value given by y = a x e(*») 
for an xX-value of ~ 1 A, where a and b have the val- 
ues ExsP "A? and E. (You calculated H and EF 
above with the LF’ function). 





Predict the other y-values in the same way and display the following results. 
Predicted Values Resulting From Transformation Example 
js [eo far [so [2 [24 [oo 
Predicted In(y) 3.63 | 2.80 1.31 a 
Predicted y 37.53 | 16.40] 7.531] 3.70 0.60 
The In(y) value for x = & is 2 . 24, which is equal (as it should be) to the intercept A. Also, the predicted y 


values above corresponding to the data x-values 4. 7, 3, and 24. 4 are reasonably close to the actual data 
y-values shown in the table on page 86. 
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Overview 


This section covers: 
e Setting and reading the calendar. 
e Setting and reading the clock. 


e Improving the accuracy of the clock. 


The HP-71 Calendar (si PORTE, GR Pe, OH Ped) 


Dates from January 1, 0000 to December 31, 9999 are accepted by the HP-71, but dates before October 
15, 1582—before January 1, 1752 for English speaking countries—do not relate directly to our current 
Gregorian calendar. 


mE TOATE numeric date 


SETOATE date string 





This statement sets the date on the HP-71 clock as either an integer or a string. The numeric date is 
entered as YYDDD or YYYYDDD, where YY or YYYY = year and DDD = the day number in that year. The 
day number ranges from 001 through 365 (or 366 for leap years), and is always entered as three digits 
including leading zeros as necessary. The form of the date string is “YY/MM/DD” or “YYYY/MM/DD,” 
and includes zeros as necessary to create an eight- or ten-character string. 


90 
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The actions of DATE and DATE# (explained below) are unaffected by the way you enter the date. The 
two methods (numeric date or date string) are provided to make it easier for you to enter the date. 


Examples: Both these statements set the date to March 7, 1985. Note the leading zero in the three- 
digit numeric day number, and the leading zeros in both the month and day characters in the date 
string. 

SETOATE &5066 

SETOATE "85-83-07" 


This function returns the date as a number in the form YYDDD, where YY = the last two digits of the 
year and DDD = the day number in that year. 


Example: Assume the date is March 7, 1985. 


Input/Result 


DATE Returns 3566, showing that March 7, 1985, is 
the 66th day of the year. 


This function returns the date in the form “YY/MM/DD”, where YY = year, MM = month, and 
DD = day. 


Input/Result 


DATE # [END LINE] Returns $5.3.87, the same date (March ds 
1985) presented as a string. 


The HP-71 Clock 


The HP-71 provides you with a versatile set of statements and functions to set and adjust your quartz- 
controlled clock and to change its speed. Once you learn how to use each of these keywords, you'll find 
it easy to change your clock’s setting in response to time zone and other time changes, and to maintain 
your clock’s accuracy to within a few seconds over weeks or months. 


There is one statement, ADJAES (adjust absolute), that adjusts the clock without introducing any 
speed correction factor. Two statements, SETTIME and ACL 21, set or adjust the clock and in- 
troduce speed correction factors. These factors are accumulated between two executions of the EXACT 
statement, and are used when the second EXACT statement is executed. Finally, one function, AF 
(adjustment factor), both introduces and executes speed correction factors. However, when AF is exe- 
cuted, the clock setting remains unchanged. The following table gives an overview of these 
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statements. Then, each keyword is discussed more fully. 


Keywords to Adjust and Correct Clock 


Clock Clock Setting Speed Correction | Speed Correction 
Setting | and Speed-Error | Based on Error Based on 
Accumulation Accumulation Argument 


SETTIME 
AO ULES T 





Setting the Clock (SZETTIMNE, AOUJHES) 


When first using your HP-71 clock, or after a clock reset,* you should use SETTINME to set the clock. 
However, once you execute EXACT, don’t use SETTIME again unless you also want to accumulate a 
speed correction factor. 

ACLIAES sets the clock without accumulating a speed correction factor. Its argument is a time incre- 
ment, like 15 seconds or "-1:88:" (adjust the clock back one hour). AOJAES is useful for 
operations like time zone changes. 


Initial Setting (ZETTIME). 


SETTIME seconds since midnight 


SETTIME time string 





The HP-71 clock can be set using a numeric expression (seconds since midnight) whose value ranges 
from 0 through 86399. The system clock can also be set using a time string of the form “HH:MM:SS,” 
where HH is hours in the 24 hour format, MM is minutes and SS is seconds. Leading zeros must be 
included as necessary to maintain an eight-character string. 


A technique for setting your HP-71 clock is given under “Setting the Time and Date,” page 17. 


After a clock reset, if SETTIME is executed bfore EXACT is executed, no part of the SETTIME 
adjustment is accumulated for speed correction; the adjustment is used only to set the clock. Once 
EXACT is executed, however, the entire adjustment is still used to set the clock, but any part of the 
adjustment other than full hours and half hours is also accumulated as a speed correction factor.+ The 
next time EXACT is executed, this factor is used to change the clock’s speed. 


* A clock reset occurs after either a memory loss or reset, or when you execute RESET CLOCK. 


+ Therefore, if you want to adjust time for time zone change, you can use SETTIME. If you reset for an even hour, no error will be 
accumulated. But if you reset the time by one hour and three minutes, the three minutes will be accumulated for error correction. 
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In summary: 
e After a clock reset, execute SETTIME before EXACT to set your clock initially. 
¢ After E*SACT is executed, use SETTINE to simultaneously: 
1. Change the clock because it’s running fast or slow, and 
2. Accumulate a speed correction factor that will be converted to a speed change by the next 


execution of EXACT. 


Examples: The following statements are executed following a memory reset, but before E¥ACT has 
been executed. 


SETTINE S286 +15%#68 Sets the clock to 8:15 AM, the number of seconds 
for 8 hours plus the number of seconds for 15 
minutes. 

SETTIME “88:15: 88" Also sets the clock to 8:15 AM. 

SETTIMNE "“18:88:a5" Sets the clock to five seconds past 6:08 PM. 


Setting Adjustment (FADIAES). 


HOIAHES adjustment in seconds 


HUIRES adjustment string 





The adjustment in seconds can be any numeric expression including one or more variables. Both a 
positive and a negative change is accepted. The adjustment string is in the form “HH:MM:SS” or 
“—HH:MM:SS.” Leading zeros must be included as necessary to maintain an eight or nine character 
string. The entire adjustment is treated like a time zone change; no part is accumulated as a speed 
correction factor. 


Example: Suppose you discover that the watch you used to initially set your HP-71 clock was 43 
seconds slow. You execute this statement to add 43 seconds to the HP-71 clock: 

AQUA S 43 

You’re flying from New York to Chicago. You execute this statement to change your clock to Central 
Standard Time: 

ADJABS ~ 3688 Sets time back 3600 seconds (1 hour). 


You continue your journey from Chicago to Denver. To change your clock to Mountain Standard Time, 
you execute this statement: 


ADUABS "-G1:08;aa" | Sets time back 1 hour. 
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Reading the Time (TIME, TIME) 


ile 


This function returns the time as a number expressed as seconds since midnight. It can be used in 
numeric expressions as can any numeric function. 


Example: Suppose you construct a program to time the durations of a series of experiments, all start- 
ing at the same time. The following statement assigns to T the starting time (seconds since midnight) 
of this series. 


eab T=TIRE 

Line 780 in your program (below) is triggered by the completion of your first experiment. It assigns to 
Ei the duration of the first experiment in seconds. Suppose your experiments began at 9:00 AM 
(32,400 seconds since midnight), and the completion of your first experiment occured at 10:30 AM 


(37,800 seconds since midnight). E 1 would be assigned the value 5400 (seconds), the duration of your 
first experiment. 


ree EL=TIMNE-T 


TIMES 


This function returns the time of day as a string with the form “HH:MM:SS,” expressed in the 24-hour 
format. 


Adjusting Clock Speed (SETTIME, ADJUST, AF, EXACT, 
RESET OCLOCE) 

The circumstances under which each of these keywords can be used most effectively are explained 
below. 

Speed Correction. Normally, each of these keywords is used in the following situations: 


e SETTINE: except for setting your clock after memory reset, use SE 7 TIME if you want its entire 
argument to change the clock’s setting, and any “minor” portion of its argument—the portion 
other than full hours and half hours—to be accumulated as a speed correction factor 


e AOIUST: use HOIUST if you want its entire argument to be added to or subtracted from the 
clock’s current setting, and the “minor” portion of its argument—the portion other than full hours 
and half hours—to be accumulated as a speed correction factor. 


e FF: use AF only if you do not want to change the clock’s setting, but do want the entire argument 
to change the clock’s speed without waiting for the next execution of EXACT. 
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AOU T seconds 
HONS T adjustment string 


This statement allows you to reset your computer’s clock for different time zones, for daylight savings 
time, etc., while at the same time accumulating a small amount of time (no larger than +15 minutes) 
for a later speed correction. This speed correction is made the next time EXACT is executed. The 
argument can be seconds, expressed as a numeric expression that, when evaluated, can range between 
—360,000 and 360,000 seconds (100 hours). The argument can also be an adjustment string in the form 
“HH:MM:SS” or “—HH:MM:SS,” where zeros are used to maintain an eight or nine character string. 


Example: You’re about to cross from Central to Eastern time. You know your clock has lost one 
minute since you set it accurately 4 months ago. You now wish to: 


1. Set your clock ahead one hour. 
2. Accumulate a speed correction factor to compensate for the clock’s slowness. 


3. Reset your clock to compensate for the lost minute. 


To perform all three operations at once, you execute the following: 


ROGUST "Gi+:+81:88" (ENDLINE 


HF «new adjustment factor: 





The adjustment factor changes the clock’s speed. It is the number of seconds that pass before the clock 
adds (positive) or subtracts (negative) one second to or from its reading. The AF function always re- 
turns the current value of the adjustment factor. If AF is executed with a new adjustment factor, the new 
value replaces the current adjustment factor. HF with its optional argument sets an adjustment factor 
directly (as opposed to AOUJUSTand SETTI ME), and does not require the execution of EF“ ACT. 


Example: The new adjustment factor changes the clock’s speed in the following way. (For this example, 
assume the current adjustment factor is 24000.) 


Input/Result 


AF Oo -2esae a Displays 24864, the current adjustment factor, 
and sets a new adjustment factor (— 28800). 


After a period about 56 seconds long (28,800/512) has passed following the execution of this function, a 
small fraction of a second (1/512) will be subtracted from the clock’s reading. 
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Correcting Accumulated Speed Errors. 





This statement is used to improve the accuracy of the clock’s speed. The first execution of Ex ACT 
following a memory reset defines the beginning of an adjustment period. Each subsequent execution of 
EFAICT defines the end of the current adjustment period and the beginning of the next adjustment 
period. All clock speed corrections accumulated by the execution of SETTIME and ADJUST during 
the current adjustment period (normally weeks or months long) are used to define a new adjustment 
factor when EXACT is executed. (Remember that SETTIME and ADJUST do not define an adjust- 
ment factor; that is, they do not change the clock’s speed. They only accumulate speed corrections.) 
The new adjustment factor defined when EACT is executed is used by the HP-71 as described in the 
FF discussion directly above. 


Since EXACT is used to improve the accuracy of the clock’s speed, you should execute it only when you 
are sure the clock’s reading is correct. 


Cancelling the Speed Adjustment Factor . 


RESET -CLOCE 





This statement clears the adjustment factor and resets the clock’s speed to that in effect after a mem- 
ory reset. No seconds will be added to or subtracted from the clock’s reading as a speed correction until 
AF or EXACT is executed again. 
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File Operations 
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Overview 


The HP-71 retains programs and data in memory in the form of files. The computer can contain sev- 
eral files at one time, each with its own name. This section discusses how to manage files. It does not 
cover the specifics of creating and adding information to files. (That is covered in other sections as 
noted.) 
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This section describes the operations that are common to all HP-71 files. More specifically it describes: 


e The current file. 
e The work file, 


e How HP-71 memory is structured. 


e Copying files. 


e Renaming files. 


e Purging files from memory. 


e Protecting files. 


e Finding out which files exist in memory. 


If you are simply going to run programs from plug-in modules, you don’t need to read this section. But, 
if you are going to use programs or information stored on magnetic cards, or plan to use HP-IL devices, 
you should read this section. 


If you want to create, add information to, or use the following types of files, refer to the indicated 
sections: 


BASIC Files. 

This type of file contains a BASIC program. These are described in section 8, “Writing and Run- 
ning Programs.” 

BIN and LEX Files. 

Files of both types are written in HP-71 machine language. A BIN file can be executed as a 


subprogram. A LEX file can add BASIC keywords to the computer. These file types are described 
in section 8, “Writing and Running Programs.” 


DATA Files. 
DATA files contain numeric and string data and are used by programs for data storage. DATA files 
are described in section 14, “Storing and Retrieving Data.” 


TEXT Files. 

This is a special type of data file which is used for transferring information between the HP-71 and 
other computers. BASIC files can be transformed into TEXT files so that they can be transferred 
to other computers. Similarly, TEXT files can be transformed into BASIC files. TEXT files are 
described in section 14, “Storing and Retrieving Data.” 


KEY Files. 

KEY files contain the key redefinitions that you create. Several KEY files can reside in the 
computer’s memory at the same time, however, only one can be active at any given time. These are 
described in section 7, “Customizing the HP-71.” 

SDATA Files. 


SDATA files are data files that can be sent to and received from an HP-41 Handheld Computer. 
These are discussed in section 14, “Storing and Retrieving Data.” 
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The Current File 


More than one file can reside in the HP-71. At any time, one file is designated the current file. A file 
can be edited only when it is the current file. Also, the current file is the default file (the file used when 
one isn’t specified) on which the computer performs many file operations. 


The following functions and statements change the current file designation: 


e ELIT. 

e RU. 

e CHAIN. 

e FREE FORT. 
e CLAIM FORT. 


FURGE (only when the current file is purged). 


Inserting or removing a RAM or ROM module from a port. 
TEAHSFORM (only when the current file is transformed into a non-BASIC file). 


The work ta 
The HP-71 maintains a program file called work¢ile, which is a scratch file. The workfile 
becomes the current file when you: 

e First install batteries. 

e Reset the HP-71 (IHIT: 3%). 

e Purge the current file. 

e Execute EDIT without specifying a file name. 

e Transform the current file into a non-BASIC file. 

e Insert or remove a RAM or ROM module from a port. 

e Execute FREE FORT or CLAIM FORT. 


For more information about using the workfile, refer to section 8, “Writing and Running 
Programs.” 
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Introduction to File Operations 


As need arises, you will probably want to create and make copies of files, rename them, and purge them 
from memory. To give you a feel for how these operations can be performed, some examples are given 
here demonstrating file operations at the most elementary levels. The details of how the statements 
shown in the following examples work are given later in the section and in the HP-71 Reference 
Manual. 


If you write a program in work ¢ile and want to give it a name, you can use the HAME statement: 





Input/Result 
EDIT Designates wiark file as the current file. 
work file BASIC Displays the file name (war k fi l=) and file 
type (BASIC). 
16 GOTO 14 Enters a line into the file. 
NAME TEST Names the file TEST. 
EDIT Creates a new workfile, 


work File 





Rather than using the work fil =, you can simply create a file with a name and enter program lines 
into it: 
Input/Result 


EQIT TESTI Creates a new file named TEST 1. It is the cur- 
rent file. 


Shows that TEST1 was created and that its file 
type is BASIC. 





To avoid confusing a file with other files having similar names, you can rename a file using FEHAME: 


Input/Result | 
REHARME TESTI To WOLTAGE1 Renames TE=T1 to VOLTAGE. 


\ 
’ 
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If you are going to make changes to a file, you might want a backup copy of the file in case you decide 
later that you don’t want to incorporate the changes. You can copy a file, giving the duplicate a new 
name using CUPF’’: 


Input/Result 
CORY SOOLTAGE! TO VOLTESTI Creates a copy of VOLTAGE1 and names it 
OLTEST1. Both files now reside in memory. 


After creating several files, you might occasionally want to know which ones you have in memory. You 
can instruct the computer to display a list of the files in memory using CHT HALL: 


Input/Result 
CAT ALL Instructs the computer to display a list of the files 
in memory. 
HATE S TYPE LEH 
TINE FORT Displays headings for catalog information. 





Shows that the oldest file is TEST. 


Displays the next file name. 





workFile ‘ASIC The next oldest file is workfile. 








VOLTAGE ‘ASIe ; Displays an entry in the catalog for the file 
WOLTAGEI. 
MWOLTEST 1 (ASIC : Displays an entry for WOLTEST 1. 





Pressing again displays the same file name, 
indicating that this is the last file in the catalog. 


Returns the BASIC prompt to the display. 
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When you no longer need a file, you might want to purge it (erase the file) to free up memory for other 
uses. You can do this using FURGE: 


Input/Result 
FURGE WOLTEST1I Purges OLTEST1 from memory. 


The quick demonstration of file operations above shows how you can create, name, rename, catalog, 
and purge the files in memory. The HP-71 gives you greater flexibility than shown here in how you can 
manipulate files. But before you can understand the details of the file operations available to you, you 
need to understand something of how memory is organized on the HP-71. 


Structure of HP-71 Memory 


The HP-71 gives you great flexibility in specifying where files are stored in memory. The HP-71 mem- 
ory can be divided into smaller sections, called ports (described below), in which programs and data can 
be stored. Storing information in a specific port enables the HP-71 to find it fast since, if you specify 
the port where your information is located, the HP-71 searches only that port rather than all of mem- 
ory. This can increase the speed of programs that use files. 


Two Types of Memory: RAM and ROM 


The HP-71 contains two kinds of memory: 
e Read-Only Memory (ROM). This memory can’t be altered. 


e Random-Access Memory (RAM). You can store and delete information in this type of memory. 


Read-Only Memory (ROM). The HP-71 contains 64 kilobytes (64K) of ROM.* The ROM contains 
the operating system and all the functions of the HP-71. You can’t write information to this memory, 
but you can increase the capabilities of the HP-71 by adding ROM modules to any of the four front 
ports (as described below). Also, you can run programs contained in ROM modules and read informa- 
tion from them. 


Random-Access Memory (RAM). The HP-71 contains 17.5K bytes of RAM, all of which is avail- 
able to the user. (However, the HP-71 uses about 1K of RAM for its operations.) You can add up to four 
RAM modules to the HP-71 to increase the amount of RAM. 


This section deals primarily with manipulating files in RAM. It also describes how to copy files from 
plug-in memory. 


* A kilobyte equals 1024 (2!) bytes. 
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Main RAM and Independent RAM 


The HP-71 contains four external ports in addition to the HP-IL and Card Reader ports. These ports 
are numbered 1 through 4, from left to right. You can plug applications modules (ROM) or memory 
modules (RAM) into any of these ports in any order. 





The HP-71 contains an additional port, port 0, which is internal—you can’t add any modules to it. 
This internal port contains 16K bytes of RAM which can be set aside from the rest of the internal 
RAM. 
The HP-71 RAM can exist in two forms: 

e Main RAM. 

e Independent RAM. 
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Main RAM. The HP-71 is initially equipped with a certain amount of RAM (described above), some 
of which is contained in port 0. This RAM, and RAM added to any ports, is called main RAM. The 
HP-71 uses main RAM for its operations, keeping files, and storing variables. 


Independent RAM. Independent RAM is memory that is internally set aside from main RAM. In- 
dependent RAM is not used by the HP-71 for its operations but contains only the information that you 
store in it. Independent RAM is useful for: 


~~ 


¢ Protecting files from a memory reset condition caused by an IHIT: @% reset. 


¢ Enabling the computer to locate files quickly, since the search for a file can be limited to one 
portion of RAM. 


¢ Enabling you to remove a memory module from a port without disturbing the information in the 
remainder of RAM. 


If memory modules were plugged into all four ports (assuming that they are not set aside as indepen- 
dent RAM), main RAM would consist of the internal RAM plus the plug-in memory, as shown in the 
following illustration: 


Internal 
RAM 


Main RAM 


Plug-in 
Memory 





Main RAM, independent RAM, and plug-in ROM are all called memory devices. For example, when 
main RAM consists of all internal RAM and all plug-in RAM (as shown in the above illustration), 
there is one memory device—main RAM. Any portion of RAM that is designated independent RAM 
becomes a separate memory device. Also, a ROM is always a separate memory device. 


Declaring Independent RAM (FREE FURT) 


The RAM within a port can be set aside as independent RAM by executing FREE FORT. 


FREE FORT «port number: 
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Example: Change the RAM in port 0 to independent RAM: 


Input/Result 
FREE FPORT¢@: Port 0 becomes independent RAM, and is set off 


from all other RAM. 


If you don’t have a RAM module plugged into any of the ports, the memory in your HP-71 can be 
represented by the following diagram, which shows the memory in port 0 having a boundary between it 
and main RAM as a result of executing the above statement. 


internal 
Main RAM 
RAM 


Plug-in 
Memory 





Note: When you remove a memory module, first free the module’s port. If you don’t first free the 
port, main RAM will be cleared when you remove the module. 


If the computer doesn’t have enough unused memory in main RAM to free a port,* you will need to 
purge some files from main RAM to make enough memory available. (Refer to “Purging Files,” 


page 115.) 


The HP-71 contains 16K bytes of RAM in port 0 which is subdivided into four 4K units. You can free 
each of these units separately by specifying them in the FREE FORT statement as 0, 0.01, 0.02, and 


0.03. (The leading zero can be dropped.) For example: 
FREE FORT, 12 
sets aside one 4K portion of port 0 as independent RAM. 


* Indicated when the FREE PORT statement results in the ERR: Insufficient Memory message. 
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Reclaiming Independent RAM (ZLAIM FORT) 


To incorporate an independent RAM back into main RAM, execute CLAIM PORT. 


CLAIM PORT «port number: 





The port number can be a number from 0 to 5. (Port 5 is the card reader port.) 
Example: Claim the memory in port 0 as part of main RAM. 

Input/Result 

CLAIM PORT¢@S 

The memory in port 0 is now part of main RAM, as illustrated below. 


Port 0 


Internal 


Plug-in 
RAM 





Note: When you claim an independent RAM, its memory is cleared by the HP-71. Therefore, you 
might want to copy files from the independent RAM to main RAM, another port, or a mass storage 
device before you claim that independent RAM. 


Obtaining Memory Information (HEM, SHOW FORT) 


When creating, storing, or copying files you might need to know the storage capacity of a RAM module 
and how much of that capacity is unused. This information is especially useful if you need to determine 
how much memory to make available so you can create an independent RAM (as described above). 


Determining the Amount of Unused Memory. You can determine the amount of unused memory 
in main RAM or an independent RAM by executing MEM. 


MEM[« port number >] 
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The integer returned indicates the number of bytes of memory that are unused. 


Examples: 

MEM. ; Returns amount of unused memory in main 
RAM. 

MEM CA Returns the amount of memory available in the 
port indicated by F. 

MEN CiS Returns the amount of unused memory in port 1. 


Determining Memory Capacity. You can determine the size (in bytes) and type of memory in a port 
using the SHOLM FORT statement. 


SHOR FORT 





Executing this statement shows the port number, the memory capacity in bytes, and the type of mem- 
ory device. ROMs and independent RAMs are shown starting with the lowest-numbered port, then all 
main memory devices. A memory type of “0” indicates main RAM; “1” indicates independent RAM; “2” 
indicates a ROM; “3” indicates an EEPROM.* 


Example: Set aside port 0 as an independent RAM, then find the memory size and type for the port. 


Input/Result 


MEM Determine if there is enough memory in main 
RAM to set aside port 0 as an independent RAM. 
(Port 0 contains 4096 bytes of RAM.) 


Displays the number of unused bytes in main 
RAM. If the number is at least 4096, this example 
will work. If you don’t have at least this much 
memory, purge some files to free up more memory 
if you want to complete this example. 





FREE FORTC@ Sets aside port 0 as independent RAM. 
SHOW PORT Shows the type and size of main RAM and port 0. 


Displays port information. Port 0 contains 4096 
bytes of independent RAM. Ports 0.01, 0.02, and 
0.03 are part of main RAM. 


m7 iy 


A, 





* Applies to the 2CCCC and later versions of the HP-71 system ROMs. Earlier versions do not show memory types “0” and “3”. To 
determine the version of system ROMs you have, execute VEF#. 


a 
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File Names 


Each file you create in memory has a name. When you perform operations on a file, you refer to the file 
by name. Before you start creating files, you should become familiar with the rules governing file 
names. 


Characteristics of File Names 


File names can be a combination of up to eight letters or digits, but the first character must be a letter. 
Characters other than letters or digits are not allowed. You can use upper- or lowercase letters, but 
they will all be converted to uppercase. 


Examples of Invalid and Valid File Names 


TANGENTIAL | Too long. THHGEHTS 


4PLEe Can’t begin with a number. FOURFLES 
Test:ilit Can't use a colon or a dollar sign. | Testi 





A file name can be an unquoted string or a string expression.* Of course, a string expression must 
evaluate to a valid file name (as described above). 


Examples: 

CORY TARGETS Uses an unquoted string to specify a file. 

COPY "TARGETS" Uses a quoted string to specify the same file. 

COPY AF Uses a string variable which evaluates to a file 
name. 

COPY AS Es Uses a string expression which evaluates to a file 
name. 


Files with the same name can exist in different memory devices (for example, in port 0 and in main 
RAM). However, an error results if you try to store a file in a port or in main RAM when a file by that 
name already exists there. For example, the following is a valid statement: 


COPY  FRAOTAL: PORTC&: To RADIAL: MAIN 





* A quoted string is the simplest form of a string expression. Therefore, when this manual refers to a string expression, it means 
that a quoted string is also valid. 
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However, this is not valid: 
COPY RPAQIAL:FORT¢&@> To FADIAL: PORTCe 


since the file name already exists in the port. 


Default Files 


For statements that operate on files, you can optionally specify a file. When you don’t specify a file, 
some statements automatically use a default file (usually the current file) for their operation. 


You can determine the default files that a statement uses by referring to the statement’s keyword dic- 
tionary entry in the HP-71 Reference Manual. Where a statement is introduced in this manual, the 
default files it uses are described. 


Reserved Words 


The HP-71 attaches special significance to certain words used in statements that operate on files. 
These words are: 


HP-71 Reserved Words 


Used in some statements to refer to all allowed options. 












ALL 
CARD 
INTO 
KEYS 
TO 


Refers to the magnetic card reader. 
Used as part of the TRAHSFOFM statement. 
Refers to the file of current key definitions (k #u4=). _ 















Used as an intermediate word in statements such as 
COPY and FEWAPIE. 


You cannot use these words as file names unless they are included in string expressions. To avoid am- 
biguity, it is better not to use them as file names at all. 


Device Names 


For file operations, you can also specify the location of a file in addition to its name. This speeds up the 
search for the specified file, and can prevent ambiguity when files of the same name reside in different 
memory devices. For this discussion, a device name is the name of a memory device, such as MAIN. 
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Characteristics of Device Names 


Device names differ from file names in that device names can’t be created by the user. The HP-71 only 
recognizes certain device names—attempting to use a device name other than one the computer recog- 
nizes generates an error. The following table shows valid device names on the HP-71: 


Valid Device Names 


Por T Specifies all ports beginning with port 0. 
PORT ¢n3 













Specifies a particular port (where n is a number from 
0 through 5) 


Specifies main RAM. 












MATH 
PARC 
FORD 





Specifies the magnetic card reader. 





Specifies a private file on the magnetic card reader. 






To specify a device in statements such as TOF and MERGE, precede the device name by a colon. This 
distinguishes it from a file name. For example 


COP file name TO : FORTH? 

copies a file to port 0. 

If you want to specify both a file and its location, use 
file name : device name 

For example, 

COPY FILE: MAIN TO :PORT¢@> 


stores a copy of FILE1 in port 0. 


Default Devices 


In many cases the HP-71 uses a default device when one isn’t specified. Generally, the following rules 
apply: 3 
When a device is not specified: 


e If a file name is specified, the computer searches for it beginning in main RAM, then in succes- 
sively higher-numbered ports beginning with port 0. 


e If a file name is not specified, the device in which the current file resides is the default device. 


If a device isn’t specified for a destination file in a C:CIF'‘* operation, the default device is main RAM. 
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File Search Order 


When the HP-71 needs to locate a file in memory (when a device isn’t specified for a file), it first 
searches main RAM, then searches the memory in each successive port, beginning with port 0. 


If FQFT is the specified device but no port number is given, then all ports are searched, from the 
lowest-numbered port to the highest. If a specific port is specified, then only that port is searched. 
Also, if (AIH is the specified device, then only main RAM is searched. 


Copying Files (© 2F *) 


The (UF statement enables you to store and retrieve files from main RAM, independent RAM, mag- 
netic cards, and to retrieve files from plug-in ROM. This statement duplicates a file that you specify. 


simplified syntax ————_______—— $$ 
Fc riF'y source file Tl destination file 


Two files are specified in the statement: 





e The source file (the one to be copied). 
e The destination file (the one to contain the duplicate). 


When you execute OF ‘’, the HP-71 creates the destination file and stores a copy of the source file in 
it. The destination file cannot already exist. 


The source file or destination file can be specified by a file name, a device name, or both. Also, you can 
execute OF without explicitly specifying a file or a device. That is, you can specify a file in one of the 
following forms: 


e file name 
e : device name 
e file name : device name 


e no file name or device name. 
When you omit a file name, device name, or both, the HP-71 uses defaults (as previously described). 


The following table summarizes the effects of 7 CIF'Y given the different combinations of specified file 
names and device names and their defaults. 
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Effects of — UF y Given Various Parameters 


Source* Destination* 


i 


X 
X 
X X 
X 
X X 
X X 
X X X 


* An X indicates that the parameter is specified. 


Computer’s Response and Example 


Copies current file, if in an independent RAM or a ROM, to main 
RAM. The destination file has the same name as the current file. | 
CoP YS 

Copies current file to specified device. The destination file has the 
same name as the current file. 

CORY TO :PORTCS3 
Copies current file to main RAM. The destination file has specified | 
file name. | 
COPY TO WNEWI | 


Copies current file to specified device. The destination file has the 
specified file name. 

PFORPY TO HEWL:FPORT¢23 

Copies file from CAFO or FC RD to main RAM. No other device 
can be specified. Destination file has same name as card file. 
COPY + PCO 

Valid only if CARO or PCFEO is source file’s device and MAIH is 
destination file’s device. Copies a card file to specified main RAM. 
Destination file has card file’s name.t 

LOP’Y CARO TO :MAIH 

If specified device is CAFO or FCEO, copies card file to main 
RAM. If a different device is specified, copies a file from specified 
device to main RAM. The HP-71 searches for a source file with 
the same name as the specified destination file.+ 

COPY :PORT¢Hs TO HAMEL 

If source file’s device is CHFED or FCO, then destination file’s 
device must be MAIN; copies file from magnetic card to main 
RAM. If source file’s device is any other, searches for a source file 
with the same name as the specified destination file and copies it 
to specified file in the specified device.¢ Destination file has speci- 
fied file name. 

COPY CARO To HEM! MATH 

COPY :AAIH TO HANEL: PORT a: 





t When only a device is specified for the source file (other than CARL or FCFL), a name must be specified for the destination file. 


$ Files from the magnetic card reader can only be copied into main RAM. Therefore, if you specify CAFO or PCED as the source file’s 
device, you can specify only MAIH as the destination file’s device. (For more information about using the magnetic card reader, 
refer to appendix C, “Using the HP 82400A Magnetic Card Reader.”) 
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Effects of (IF Given Various Parameters (continued) 












| Destination* 


X 





Computer’s Response and Example 









Copies specified file to main RAM. Destination file has same name 
as source file. 
COPY OLO1 
Copies specified file to specified device. Destination file has same 
name as source file. 

COPY OLOL TO :;FPORT® So 
Copies specified file to main RAM. Destination file has specified 
name. 

COPY OLOL TO WHEWI 


Copies specified file to specified device. Destination file has 
specified name. 

CORY OLO1 TO WHEWL:FPORTE 1: 
Copies specified file in specified device to main RAM. Destination 
file has same name as source file. 
COPY OLOL: PORT 35 
Copies specified file in specifed device to specified destination de- 
vice. Destination file has same name as source file. 

COPY OLOLi:;FPORTC S39 TO :FOoRTCL: 
Copies specified file in specified device to main RAM. Destination 
file has specified name. 

COPY OLOL:FPORT* 33 TO HEMI 
Copies specified file in specified device to specified destination 
device. Destination file has specified name. 

COPY OLOL: PORTS S> To HEWL: PORTS 1: 


* An X indicates that the parameter is specified. 
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Renaming Files (#2 & hFiFir) 


Files can be renamed with FEHAME. 


simplified syntax 
REMAME old file name TU new file name 


An old file name can be expressed as: 
e File name. 
e File name : device name. 
e Blank. (Defaults to current file.) 


A new file name can be expressed as: 
e File name. 
e File name: device name. 


There is no default for a new file name—you must always specify it. The file’s device can be specified 
with either the o/d file name or the new file name. 


Examples: 

REHARE TO FILES Renames current file to FILE. 
BonaME PELE I. TO Fhe Renames FILE to FILE. 
RENAME FILEL:FORT*@) TO FILE2 Renames FILE in port 0 to FILE. 
REHARE FILE TO FILES: FORT es Renames FILE1 in port 0 to FILE=. 
Purging Files (iii iz&) 


To purge a file from RAM, use FURIE. 





The default file for this statement is the current file. If you specify a device, you must also specify a file 
name. 
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Examples: 

PURGE LOGIC! Searches for a file named LUGIC1 and if found, 
purges it. 

FURGE PROTON: SALIH Purges a file named FR OTOH from main RAM. 

FURGE Purges the current file. 


You can purge all unsecure files in main RAM by executing FURGE ALL. 
| PURGE ALL 


Executing FURGE ALL doesn’t affect files stored in independent RAM. 


Merging Files (*inkisi) 


You can use the MERGE keyword to integrate a BASIC file into the current file or a KEY file into the 
system i: «t= file. Merging BASIC files is discussed here; merging a KEY type file is discussed on page 
128. 


— simplified syntax 


MERE source file [, start line or key number [, final line or key number ]] 





i 


The source file is the file you wish to merge into the current file. The default values for start line and 
final line are the first line and the last line in the source file. The source file is not changed by a MEF GE 
operation. 


All line numbers are correctly inserted into the current file. If the same line number exists in the 
source and current files, the line in the source file replaces the line in the current file. To ensure that 
all lines in the current file are preserved, you can FEHLMBEFR either the source or the current file. 


Examples: 


MERGE FILET*PoRT¢ 13 Merges all of BASIC file FILEi in port 1 into 
the current file. 


Merges lines 70 through 150 of BASIC file 
KE IHAHIS1 into the current file. 


MERGE FILES, 1ae Merges file FILE into the current file starting 
at line 100. 


MERGE RIMAWHTSLT, Fe, Poe 


‘eweke' 
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File Security 


The HP-71 enables you to perform many operations on files, such as viewing, modifying, and copying. 
However, in some situations you might want to prevent these operations from being performed on a 
file. For instance, you might not want a program to be viewed or modified by others. The HP-71 en- 
ables you to control the access to files and protect them from being modified, purged, or viewed. 


Protecting a File’s Contents (SECURE, UHSECURE) 


You can protect a file from being modified or purged using SECLIFE. The effects of this statement can 
be reversed by the statement LIHSECURE. 


mELURE [file name [: device]] 





LH SECURE [file name [: device]] i 





You can secure any type of file. A secure file can’t be altered or purged. However, you can execute it (if 
it is a program file), view its contents, read from it, or copy it. 


Controlling File Access (FF I'VATE) 


You can prevent your file from being viewed, copied, or modified using FFIWATE. 





FRIVATE file name [: device] 





The FR IWATE statement is permanent—you can’t reverse its effects. 


Since this statement has such lasting effects, you must explicitly specify a file for the statement. This 
ensures that you don’t accidentally make the current file a private file. 

Examples: 

PEIVATE BEARING 

PRIVATE AZIMUTH: PORTCe 3 

PEIWATE operates on program files only. You can execute or purge a private file in memory, but no 


one (including you) can view, copy, or modify it. (You can copy private files from magnetic cards to 
memory, but you can’t copy them to other parts of memory or back to magnetic cards.) 
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Using Both SECURE and FETVATE 


A program file can be both private and secure. The table below summarizes the type of operations that 
can be performed on a file that has been protected with FRIVATE, SECURE, or both. 


Operations Permitted on Protected Files 


INSECURE 


ce TLR 
(default) eee 


Not Private (default) | Execute Execute 


View/Copy View/Copy 
Modify/Purge 

PRIVATE Execute Execute 
Purge 





If a file is both SECURE and FE IWATE, the file can only be executed. If you execute INSECURE on 
such a file, you can execute it and purge it, but because it is a private file, you can’t modify it. 


File Catalogs 


When you need information about files in memory, you can use CHT ALL to obtain a catalog of mem- 
ory files. 
A catalog gives you the following information about a file: 

e File name. | 

e Type of security. 

e File type. 

e Size of file (in bytes). 

¢ Date file was created. 

¢ Time file was created. 

e Port (if any) in which the file is located. 
Catalog information is always returned in the same format. Catalog information returned for more 
than one file is preceded by a catalog header. For example, when you execute CAT ALL, the HP-71 
first displays: 

HARE = TYPE LE F DATE TIME FORT 


To obtain a catalog of all files in main RAM, independent RAM, and plug-in ROMs (these are 
collectively called memory devices), execute CHT ALL. 
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HT “Ab 


This statement displays the catalog information for the files in each memory device, starting with 
main RAM. By pressing and [A], you can display the catalog entries for each file in a memory 
device. To view the first and last catalog entries for a memory device, press [g][A} and (g][y] 
respectively. 


When you want to display the catalog information for the next memory device, press [f][—LINE]. For 
example, if you are viewing the catalog entries for main RAM, pressing [f][-LINE] enables you to view 
the entries for port 0 (provided that port 0 has been set aside as independent RAM). By pressing 
[f)[CLINE] again, you can view the entries for the memory device in the next higher-numbered port and 
so on. Before displaying the catalog for the next port, the computer displays the catalog header again. 


The following table summarizes the keystrokes that enable you to view catalog entries when you ex- 
ecute a catalog function. 


Catalog Viewing Keystokes 


Keystrokes Computer’s Response 


Displays the next catalog entry in a memory device. 
Displays the previous catalog entry in a memory device. 
(g]ly] Displays the last catalog entry in a memory device. 
(9 ][A] Displays the first catalog entry in a memory device. 


Enables you to view the entries for the next memory 
device. After viewing entries for last memory device, 
returns the computer to the BASIC prompt. 














Sometimes you might want catalog information for a specific file or all the files in a specific memory 
device. You can get a catalog for: 


e All files in main RAM, independent RAM, and plug-in ROMs. (CAT ALL.) 

e All files in main RAM only. (CAT: MAIH.) 

e All files in all ports. (CAT: FORT.) 

e All files in a specific port. (CAT: FORT <2.) 

e A file specified by name. (CAT FILE1.) 

¢ A file specified by the order in which it is stored in a memory device. This is the order it appears in 
the catalog for the memory device. (TA T#“ 22.) 


If you want catalog information for specific files and ports, refer to the keyword dictionary entries for 
CAT and CAT# in the HP-71 Reference Manual . 
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Overview 


This section covers: 
e The power of user-defined keys. 
e Saving several sets of key definitions. 
e Using an active keyboard during program execution. 
e Creating and using your own set of characters. 
e Protecting portions of the display from character entry. 
e Using already displayed characters in a program or key definition. 
e Controlling each of the 132 columns of dots in the display. 
e Locking your HP-71 against unauthorized use. 


e Four ways you can control how your HP-71 displays information. 


Redefining the Keyboard (iF &E‘) 


You can redefine every key on the keyboard except the two shift keys, [f] and [9], to act as typing aids 
or to execute one or more commands. Not only can you redefine the primary functions of keys, but also 
each of the two shifted functions as well (accessed with [f] and [g]). Key definitions are automatically 
placed in a special system file, k #4, discussed later in this section (page 127). 





[DEF] REY key name [. assigned string [assignment type]] 


CIEF is optional. The key name can be specified two ways, by the keycap symbol (alone or with F or &) 
or by the identifying key number. If the assigned string (and assignment type) is omitted, the statement 
cancels any user definition for that key, and the key reverts to its Normal keyboard definition. 


The assigned string specifies the typing aid or the one or more commands assigned to the key by the 
(EF EE statement. The assignment type specifies which of three different types of key definitions 
the statement specifies: typing aid, display and execute, or execute only. If the assignment type is omit- 
ted, the key definition is a display and execute type. 


The key name and assigned string can be specified using any valid string expression, including quoted 
strings. 
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Specifying Key Name 


By Character. Often the simplest way to specify the key is to use, within quotation marks, either one 
or two characters to represent the unshifted or shifted key. For all keys—except letter keys—that dis- 
play characters, the following applies: 


For an unshifted key, use the character displayed when the key is pressed. 
For an (f]-shifted key, use the unshifted character preceded by the letter F (or *). 
For a (9]-shifted key, use the unshifted character preceded by the letter G (or 3). 
For letter keys, we’ll illustrate the general rule using [a] and [A] as examples. Any one of the following 


character key names refers to the keystroke(s) that displays a: "9a", "9H", "Ga", "GA",and "a". 
The only character key name that refers to the keystroke(s) that displays A is "A". 


When lowercase is set and is pressed on the User keyboard, any string assigned to [a] is displayed 
and/or executed. When lowercase is set and (a] is pressed, any string assigned to (A] is displayed and/or 
executed. 


Examples of DEF KEE‘ Key Names 


| Key Name | Represents on the Normal Keyboard 


"FH" | The [f]-shifted (H] key. 
Wogm The (9]-shifted [-] key. 





























a The keystroke(s) that produces lowercase “g." 
we! The keystroke(s) that produces uppercase “Q.” 
Gt The [9]-shifted key. 

"GE" The keystroke(s) that produces lowercase “b.” 


eo The keystroke(s) that produces lowercase “d.” 


By Key Number. There are some keys, like [ON], that cannot be redefined using a key character, 
since they do not display a character when pressed. Any such keys, and any other unshifted or shifted 
key (except the shift keys (f] and (9]) can be represented by a system-assigned key number preceded by 
the # symbol, all enclosed in quotes. As shown in the following diagrams, unshifted keys are numbered 1 
through 56, [f]-shifted keys are numbered 57 through 112, and (9]-shifted keys are numbered 113 
through 168. 


The table below indicates the relations between key number, the displayed character represented by 
that number, the keystroke(s) represented by that number, and letter case setting. 


Key Number Examples 


Po Uppercase Set | Lowercase Set 










Key Number 15 Represents | fi and A and (g][A] 
Key Number 127 Represents | = and (g][A] = and 
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Notice that key number 15 always represents uppercase H, but the keystroke(s) represented by number 
15 depends on which letter case is active when the key definition is used (from the User keyboard). 


As the following diagrams show, nine numbers are not used—44, 45, 52, 100, 101, 108, 156, 157,and 164. 
These are the numbers that would identify [], (9], and the lower half of the key. These 
numbers assume uppercase is set. Numbers for (f] and (9] are not useable. 


Key Identification Numbers 


Unshifted Keys 


Key Code 
Key 


Key Code 
Key 
Key Code 
Key 


Key Code 
Key 





(t] Shifted Keys 












Key Code 60 61 62 63 64 66 67 68 69 70 
Key mel ars FOR TO NEXT | DEF KEY ne LR | PREDV | MEAN j SDEV | SQR 
Key Code 74 75 76 77 78 79 80 82 83 84 
Key a ae erin GOTO | INPUT | PRINT | DISP DIM BEEP | FACT COS TAN EXP 
Key Code 85 86 87 88 89 90 91 92 93 9 96 97 98 
Key | EDIT CAT | NAME | PURGE } FETCH | LIST |DELETE | AUTO | COPY ASIN | ACOS | ATAN | LOG 
Key Code 99 102 103 104 105 106 107 109 110 111 112 
Key | OFF SST | BACK |—-CHAR| |/R LC — LINE USER | VIEW | CALC | CONT 








[9] Shifted Keys 


gq 
. a 150 151 153 154 
CMDS | # @ 
155 158 159 162 163 165 166 167 168 
CTRL i A Y 1 USER < > ? 






Key Code 
Key 
Key Code 
Key 
Key Code 
Key 


Key Code 
Key 
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Example: 


heady This represents [f}[RES ]. 


Types of Key Definitions 


Typing Aids (:). If a semi-colon follows the assigned string in a key definition, the string is displayed 
but not executed when the specified key is pressed on the User keyboard. 


Immediate Execution. If no symbol follows the assigned string, the string is first displayed, then 
executed when the key is pressed on the User keyboard. The assigned string is displayed at the current 
cursor position, and the HP-71 attempts to execute the entire line, including any characters already in 
the display when the defined key is pressed. This type of key definition can be useful as a typing aid to 
supply the last part of a command or input line. 


Direct Execution (:). If a colon follows the assigned string, the string is executed directly without 
being displayed. Any characters in the display are ignored when an execute-only key is pressed. One 
way this type of key definition can be used is to provide a response to an IHF LUT statement. 


Examples: The following examples assume the uppercase letter set is active. 
EP Rey “es SRN: Goes 


Assume a program named (LCE is in memory. When you press [9][C] on the User keyboard after 
executing this key definition, the CLOCK program runs. The quotes around CLOCK are optional. 


REY "#34" .CHRF CoS 3 : 


When you press on the User keyboard after executing this key definition, the HP-71 displays 
the integer division operator, «.. Notice that CHE #322 is not enclosed in quotes. If quotes enclosed 


CHR ¢¢ 32> in this key definition, you would display the characters (HE#* 32% when you pressed 


(f}[RES] on the User keyboard. 

KEY "FE", "CHEE": 

This statement assigns a typing aid to(f][C]. This typing aid makes it easier to enter a (:HF'# function. 
DEF KEY "Fa", "PasP4, 95" 


Neither a semi-colon nor a colon ends this key definition, so pressing displays, then executes 
the assignment statement. 
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Viewing and Editing Key Definitions (FETCH FEY, EEYDEF#, (](view)) 


The FETCH KE‘ statement returns the specified DEF KE‘ statement into the display for viewing 
and editing. The EF E'D.EF # function returns the assigned string portion of the DEF KE‘ statement 
(the typing aid or command assigned to the key) for viewing only. 


FETCH KEY key name 





Both FETCH EE‘ and COEF EE’’ use the same key name specification. 


Examples: These show FETCH EE‘ used to display two of the key definitions made above. 


Input/Result | 
FETCH KEY “* Displays the key definition assigned to lowercase 
“a” 
-QEF KEY ‘c', 'RUH "CLO This key definition is displayed in the same form 
ee as it was entered (the optional quotes around 





LUCE are displayed). You can edit and reenter 
the definition. 


FETCH KEY "#94" You must use the key number for [f][RES], since 
the HP-71 does not recognize FES as a symbol 
for [f][RES]. 


REVOEF# key name> 





The EEYOQEF# function uses the same key name specification as is used by DEF KE’ and 
FETCH KE‘. 
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Examples: These show KE'/LIEF # used to display the other two key definitions made above. 


Input/Result 
REYTOEFSC* Fo) 


The string assigned to is displayed, preceded 
by :, showing that this definition is a typing 
aid. 





KEYOEFS¢"FS" 3 


The blank space preceding this statement identi- 
fies the key definition as the type that displays, 
then executes. 





Pressing [f][ VIEW] enables the next key pressed to display, while held down, its assignment string, pre- 
ceded by a semicolon, blank, or colon to identify the assignment type. If the key has no user definition, 
it displays Unassigned. For example, pressing [f][VIEW], then [9][C] (uppercase active) displays, 
while (C] is held down, :FUN "CLOCK". (This is the definition assigned to [C] on page 124). 


Activating the User Keyboard (lISEF, [f][USER], (9][1 USER]}) 
Whenever the User keyboard is active, the USER annunciator is visible in the display. 


The LISER statement has three forms: 


WISER 


WSeER OH 
WSER OFF 





LISEF switches the User keyboard from its current state to the opposite state (from active to inactive 
or from inactive to active). Pressing [f][USER]} is the keyboard equivalent of executing USER. It ac- 
tivates and inactivates the User keyboard. 


USEF OH switches the User keyboard from inactive to active (unless the User keyboard is already 
active). 


IISER OFF switches the User keyboard from active to inactive (unless the User keyboard is already 
inactive). 


Pressing [9][7 USER] activates or inactivates the User keyboard for only the next shifted or unshifted 
keystroke. This is especially useful if you want your User keyboard to be inactive for all keystrokes 
except when you’re pressing a particular user-defined key. 





Section 7: Customizing the HP-71 127 


KEY Files (SECURE, UHSECURE, CAT, COPY, FEHAME, 
PURGE, LIST, MERGE) 


When you make your first key definition, a special file named |: = y= is automatically created in which 
that and subsequent key definitions are stored. You can LIST, COP’, REHAME, MERGE, SECU RE, 
UN SECURE, and FURGE the keys file, and you can display its catalog with CAT KE''S and 
CAT ALL. 


File of Current Key Definitions. All current key definitions are stored in the system k eu= file. 
When the User keyboard is active, all key definitions in the k = '4= file are active. While the k eu file 
cannot be made private, it can be made secure with the SECURE KE‘''S statement, and unsecure with 
the UHSECURE KES statement. (Refer to page 116 for a discussion of file security.) 


Creating Several Files of Key Definitions. You can create other KEY files in addition to the 
k 42 file. While only the key definitions in the k = 4= file are current, you can exchange any of your 
KEY files with the k ey file, thereby designating any of your key definition files as current. Such a 
file exchange also saves the key definitions previously in k = y= for future use. You can use the follow- 
ing statements to exchange files between k == and another KEY file: 


e REHHME EEYS TO file name, 

e LUFY EFEYS TO file name, 

e LOPY filename TO KEYS, 

e REHAME filename TQ EEYS. 
Listing the k 2y= File. Executing LIST KES displays each key definition in the k 2 file in 
key-number order, defined in the diagrams on page 123. Each definition is displayed in (EF KE‘ 


format, and remains in the display for a period defined by LELA'’ (described on page 26). You can list 
a portion of the k +45 file (one or more definitions) by specifying a key number or key number range. 


Examples: 

LIST KEYS; 1,14 Lists all key definitions assigned to the unshifted 
top row keys. 

LIST KEYS,24 Lists the key definition assigned to the [=] key. 
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Merging a KEY File To |: ==. You can merge a KEY file you have created into the system k #u= 
file. 


MERGE file name [: device] [, start key number [, end key number]] 





The file name, with optional device name, specifies the KEY file you wish to merge into the = file. 
Key definitions in any KEY file are ordered by key number, lowest key number first. If no key numbers 
are given, the entire file is merged into k = 45. If only the start key number is specified, only the defini- 
tion with that key number is merged into |: ==. If both start key number and end key number are 
specified, all key definitions with key numbers in that range are merged into k: 4=. Any definition in 
|: #4, whose key number is the same as a key number being merged, is deleted, and the key definition 
in the file being merged replaces it. The file being merged is not altered. After HEFGE is executed, the 
specified file exists unchanged; only the k = y= file is altered. 


Examples: 

MERGE KEYS1,1,14 Merges any key definitions assigned to the 
unshifted top-row keys from FE‘? 51 into keus. 
Any unshifted top-row key definitions previously 
in k =y= are replaced by the definitions being 
merged. KE *'S1 remains unaltered. 

MERGE KEYS2,6° Merges the key definition in EE'S2 assigned to 
the (f]-shifted [7] key into keys. 


MERGE MATHEEYS Merges the entire file MA THEE'YS into keys. 
: The key definitions in MA THEE'S are added to 

the definitions in k #42. Any keys defined in 
both files will have the MATHEE‘'S definition. 


Cancelling Key Definitions 


Executing a DEF EE‘ that includes the key name but no assigned string cancels any key definition 
assigned to that key and removes the definition from the k y= file. 


Example: 
REY "#155" Cancels the key definition assigned to [9][ON}. 


To cancel all current key definitions, execute FUR GE KES. Or, if you want a copy of your key defini- 
tions preserved, execute REMAMNE KEYS TU file name. 
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Program/Keyboard Interactions 


There may be situations where it’s useful to respond directly to a running program rather than re- 
sponding to an IHF'LIT statement. The HP-71 provides three types of direct response. A running pro- 
gram can: 


e Test if any key or a specified key is pressed. 
e Determine which keys have been pressed. 


e “Press” a key. 


Testing for a Pressed Key (KE DIOL i) 


EE OOWH 





This form of the KE ‘DOH function returns a 1 if any key, including [f] or [9], is down at the moment 
KEYOOMH is executed, and a & otherwise. 


REVYOOMHM ¢key name: | 


ala ea ics 








reas 








This form of KE CCWH returns a i only if the specified unshifted key is pressed. Otherwise, a & is 
returned. The key name can be specified by symbol or by key number in the same way key name is 
specified for DEF KE‘', except that shifted keys are not accepted. 


Examples: 


E=KEYOOMH S's If the [7] key is down when this statement is ex- 
ecuted, the statement assigns 1 to kK; otherwise I 
is assigned 0. 


S=KEVYOOMM OCHRE CaP If the key is down when this statement is ex- 
ecuted, the statement assigns 1 to “3 Otherwise + 
is assigned 0. 

E4=KEYOOWHS "#18" 5 If the (P] key is down when this statement is ex- 
ecuted, the statement assigns 1 to 4; otherwise 
K+ is assigned 0. 
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Determining Which Key Has Been Pressed (EE ‘i =) 


Up to 15 keystrokes can be stored by the HP-71 in a special storage area called the key buffer. Or- 
dinarily, when you press a key, the keystroke is momentarily stored in the key buffer, then removed, and 
the key’s action appears to occur immediately. However, if you press a key while a program is running, 
the keystroke is stored in this key buffer. 


Note: If a ( TSF statement sends an end-of-line message to the display, and the DEL A‘ is not 
zero, the key buffer is reset (no keystrokes remain in the buffer). 





This simple function removes the oldest key in the key buffer and returns its name in the same format 
as DEF KE’, KE‘ OQOWH, and EE DEF # expect. 


Example: This program turns your HP-71 into a two channel counter. It could be used, for instance, 
to keep track of the numbers of children and adults attending a fund-raising function. Suppose you 
were positioned at the ticket table. You press [+] for each adult and (-] for each child that passes. The 
display shows a running total of each, adults on the left of the display, children on the right. To reset 
both channels, press [R]}. 


Execute EQ IT THOCOUNT and enter this program. 


10 |! TWOCOUNT 


20 STD @ DIM A$,l,J Display shows no decimal point. 

30 DELAY 0,0 Allows maximum counting speed. 

40 |=0 @ J=0 

50 DISP I;TAB(10);J 

60 A$=KEY$ 

70 IF A$=*."THEN I=1+1 @ GOTO 50 Pressing (:] increments left counter. 
80 IF A$=“+"THEN J=J+1 @ GOTO 50 Pressing [+] increments right counter. 
90 IF A$=“R’THEN 40 ELSE 60 Pressing (R] resets both counters. 


If no keys are pressed while this program is running, the program loop, lines 60 through 90, executes 
repeatedly. If [-] is pressed, I is incremented by one, if [+] is pressed, | is incremented by one, and if (R] 
is pressed, both counters are reset to zero. 


The key to the program is line 60. Each time the HP-71 executes H#=KE‘'#, the name of the first key 
pressed since the last execution of line 60 is assigned to A#. 
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If more than one key is pressed between consecutive executions of line 60, the name of the first key 
pressed is assigned to H#. If more than one key, on the average, is pressed between consecutive execu- 
tions of line 60, the key buffer will become filled. Each time the HP-71 executes the program loop, the 
name of the oldest key in the buffer will be assigned to H#, but more than one key will be added to the 
buffer. After 15 keys become loaded into the buffer in this way, some pressed keys will be lost. 


In practice, it is very difficult to press more than one key between consecutive executions of line 60, so 
it is very unlikely that a user of the THOCOUHT program would fill the key buffer. However, if the time 
period between executions of KE''# in another program is long enough, a user of that program might 
fill the key buffer. This could cause some pressed keys to be lost, which in turn might cause the pro- 
gram to operate in an unpredictable manner. So when you use EE‘'# in a program, keep the time 


between executions of KE‘ # short. 


When you run THMOCOUNT, to ensure that the program does not miss keystrokes, be sure to release 
one key before pressing another. 


To stop the program, press to pause the program, then execute EHO. 


Causing a Program to “Press” a Key (F'LIT) 


FLT key name 


The key name is specified in the same form as used for DEF EE’. When FLIT is executed in a running 
program, its effect is generally the same as if the key specified by key name were pressed on the 
keyboard. : 


Example: This CLOCK program displays a running clock, both time and date, and avoids the 
unchanging displays given by TIME and DATE# alone. This also shows how a program can be con- 
densed using concatenation. (Create a file by executing EDIT LOCKE, then enter the program.) 


10 DELAY 0 @ FOR X=1 TO 30 @ DiSP Place three spaces between the quotes. 
TIME$& “  "& DATE$ @ NEXT X @ 
DELAY 1 @ PUT “#43” 


As the diagram on page 123 shows, key number 43 is the key. Pressing (that is, pressing 
[ATTN]) clears the display, then displays the BASIC prompt and the ‘flashing cursor. When 
FUT "#42" executes, a running program is not suspended; the SUSP annunciator is not turned on. 
FUT "#43" puts the key in the buffer, but does not stop the program. The program stops 
following the execution of the last statement (which in this case happens to be FLT "“#43"). When 
the program stops, leaves the buffer, and the display clears. 





132 Section 7: Customizing the HP-71 


The effect of PUT "#43", when executed by this program, is the same as pressing after the 
program is finished running. To check this, modify your CLOCK program by adding an ! just before © 
PUT "#43", converting the PUT instruction into a remark. Now run your CLOCK program. When 
the program completes its execution (when the PRGM annunciator turns off), you'll see that your dis- 
play retains the last time (and date) displayed by your program. Press [ATTN] and see the aes clear 
and the BASIC prompt and cursor appear. 


Now remove the !, reactivating your FUT statement, run [LOCKE again, and see the same prompt plus 
cursor display occur under program control. 


Since you assigned RUH "CLOCK" to (9](C] above, you can display the time and date at any time 
even with the Normal keyboard active by pressing and holding down [9], then pressing the (0] and 
keys. (Remember that [9][1 USER] activates the User keyboard only for the next unshifted or shifted 
keystroke.) 


Alternate Characters 


Characters with ASCII character codes from 128 through 255 normally represent the same characters 
as those with codes 0 through 127. This is shown by the “HP-71 Character Set and Character Codes” 
section in your reference manual. However, you can define every one of the 128 characters in the range 
128 through 255 to be anything you want, provided you can represent each character by a dot pattern 
six dots wide by eight dots high. 


Defining Alternate Characters (CHHESET, CHHESET#) 


The character code assigned to each of your alternate characters is automatically supplied by the 
HP-71. The first character you define is assigned code 128, the second 129, and so on. When you define 
your first alternate character, you use only CHAR SET. For every character after the first, it often helps 
to use both CHARSET# and CHARSET. 


CHARSET charset string 


CHARSETS 
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The charset string represents the dot pattern of all existing alternate characters, as explained by the 
example below. CHAR SET# is a function that returns this charset string. When creating your first 
character (CHE #¢1252), you execute a CHAFSET statement that specifies the six columns of dots 
making up that character. When creating your second character (CHR #41252), you must specify all 
12 columns of dots that define both of your alternate characters. The first six columns can be repre- 
sented by the CHAR SET# function, so you need only specify individually the next six columns of dots 
that make up your second character. If you were creating your ninth character, you'd use CHHRSETS 
to represent all eight of the existing alternate characters, so you again would have to specify addition- 
ally only the next six columns of dots that define the character you’re adding to the set. 


Defining the First New Character. With the help of the diagram on the next page, we’ll define as 
CHE#¢1l25° an “integrate” symbol. Here are the steps to follow. 
1. Draw a 6x8 dot pattern, and indicate which dots should be turned on to display the desired picture. 


2. Each column represents one byte of the six-byte character definition. Each row in a particular 
column represents one of the eight bits (dots) in the byte represented by that column. To help 
assign values to each turned-on dot or bit, write the decimal value of each bit on the right next to 
each bit row. 


3. Now add up the values of the dots in each column to get each byte value. In our example, all dots in 
the sixth column are off, giving a byte value of zero. It’s good practice to keep this sixth column 
blank to separate adjacent characters. 


4. Now you're ready to write your CHARSET statement as follows: 
Example: When you execute this statement, you'll have a new CHE #¢1287, an integrate symbol. 
CHARSET CHREC 64 3 & CHR ECL ES3R CHREC LSE 3 RCHRECLORCHREECSIRCHREC AS 
Execute this statement, then execute CHR#¢iz2 = to display your integrate symbol. 


The CHF function is used with CHAR SET only as a vehicle to deliver the byte values of your new 
character to the HP-71. The character represented, for instance, by CHE #647, the & symbol, has no 
significance here except as a special way to represent the number 64. 
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Alternate Character: Integrate Symbol 


Bit values 
of rows 
OOUSUL 1 
OOUGUEBLU 2 
NOBUO 4 
OOBUUC 8 
OOBUUL 16 
OOBOUU 32 
BOB UUU 64 
O@OOUU 18 
64128 2 1 2 Q 
4 
8 
16 
32 
64 


64 128126 1 2 0 Byte values of columns 


Defining Additional New Characters (CHAR SET#, CHAR SET). The first alternate character you 
create replaces existing character CHF #1257, the second replaces existing character CHR#¢1e3., 
and so on. If you have previously defined alternate character CHR #122, and now wish to add an- 
other alternate character, you must combine the CHE #¢125° charset string with the dot pattern of 


your new ZHE#*1232 character to form a new charset ‘string. 


If the number of bytes (dot columns) defined by a CHAF SET statement does not consist of a multiple 
of six bytes, the last byte or bytes of the last character definition are assigned zero values (blank col- 
umns). So the final CHE #42 could have been omitted in this example. 


However, if your CHAF SET statement defines more than one character without using CHAR SET (if 
more than six CHF functions are used in your CHARPSET statement), and you want a character- 
separating blank column, you must specify CHF #* 4% as a character-separating sixth column for any 
character other than the last. Otherwise, since CHHFSET counts off six bytes for each character, 
CHARSET will take what you intend as the first column of the next character and make it the last 
column of the previous character. 


You cannot define more than 128 alternate characters in one set. Character codes above 255 specify the 
existing 0 through 255 set of characters (modulo 256), including any existing alternate characters. 
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Preserving and Destroying Alternate Characters 


Since the CHAR SET# function returns the active alternate character set, you can preserve an al- 
ternate character set by assigning the value of CHAR SET# toa properly dimensioned string variable. A 
string variable with its default dimension of 32 can hold up to five alternate characters. Each column of 
dots is defined by one character, so one alternate character (six columns of dots) requires six char- 
acters, and five alternate characters can be stored in a string variable whose length is 30 characters. To 
store more than five alternate characters in a string variable, you must dimension the variable before 
you assign CHAR SET # to it. 


To destroy all alternate characters, execute CHAFSET"". 


Protected Display Fields (i! 1/0) 


You can protect part of your visible display so that the characters in that part are unaffected by most 
operations. If characters at the left of the display window are protected, the BASIC prompt and flash- 
ing cursor are positioned just to the right of the protected portion, and define the left boundary of the 
active display. This active display section is where most normal display actions occur, such as keyboard 
entry, scrolling, display of [.I5F statements, display of program listings, etc. 


MIMOOM first column [ . last column] 


The portion of the display window defined by this statement is the part that remains active. The part 
or parts of the window lying outside this defined portion are protected. The first column can be any 
numeric expression rounded to an integer in the range 1-22. The last column can be any numeric 
expression rounded to an integer in the range first column through 22. If fast column is omitted, the 
value is assumed to be 22. | 


Examples: 


mt 


MIHOOM 3,22 The characters in the display window’s first four 
character positions are protected by this state- 
ment. The display’s active portion consists of 
positions 5 through 22. 


HINHOOW This statement protects column 1 through 6, leav- 
ing columns 7 through 22 still active. 


MWIHOOW 


Ty 
feooete 
me 


Both ends of the display window are protected by 
this statement. The left end is protected from 
column 1 through 5, while columns 19 through 22 
inclusive are protected on the right end. The ac- 
tive part consists of character positions 6 through 
18. 
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The protected portion of the display window will remain unchanged until one of the following occurs: 


e Another HH IHDOM statement is executed that defines a different protected field. For instance, ex- 
ecuting HH IHG 1 would make the entire window active. 


e A GOISF statement (described below on page 137) is executed that changes the dot pattern in the 
protected area of the display. The locations of the active and protected portions of the window are 
unchanged by GLISP. The new dot pattern in the protected area becomes protected immediately. 


e An IHIT: 1, INIT: #,or INIT: @ reset ((ON](/]) is executed (section 1, page 13). 


e A memory reset occurs due to power loss or other reason. 


Reading Characters From the Display (2): ==) 


The ['I1SF# function returns a string of length zero to 96 characters, containing all readable char- 
acters in the display. Readable characters are those sent to the display while the cursor is on, D1 SF # 
allows a number (4!AL ¢015F#2) or string keyed into the display to be used directly by a user-defined 
key or a subsequently run program. 


DOISPs 


All characters sent to the display while the cursor is on are considered readable. All characters sent 
with the cursor off are considered non-readable and will not be returned by this function. If the display 
is empty, (. ISF# returns the null string. 


Examples: The following two key definitions allow easy conversion between Fahrenheit and Celsius 
degrees. These examples assume uppercase is set ((C] displays (), the Normal keyboard is active, and 


the display format is FI é. 


Input/Result 

DEF KEY "“"C","CVALCOISP#> This execute-only key definition assigns the 

42594509") Fahrenheit-to-Celsius conversion formula to 
uppercase “C.” 

212 (9)[7 USER] Displays 144.4, the Celsius equivalent of 
212°F. | 

DEF KEY "F","CVALCOISP#> This execute-only key definition assigns the 

tafe tens Celsius-to-Fahrenheit conversion formula to 

uppercase “F.” 

© (9][1 USER] Displays 22.4, the Fahrenheit equivalent to 


zero degrees Celsius. 
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Display Graphics 


You have control over each of the 132 columns of dots in your display window. You can display any dot 
pattern you wish, and you can store any dot pattern you wish. Two important keywords used for display 
graphics as well as alternate characters are CHAR SET and CHAFSET#. We'll describe here two more 
keywords primarily used for display graphics. Following that we’ll show you a graphics program. 


Reading Individual Columns of Dots From the Display (Gf! 1 =F #) 


GOLSPS 





This function always returns a 132 character string, where each character represents the dot pattern of 
one of the 132 columns of dots in the display. The first character of this string corresponds to the first 
dot column of the display window, while the 132nd character corresponds to the last column. G01 SF# 
treats each dot column as a byte, just as CHAR SET and CHARSET# do. The least significant bit (the 
one’s bit) of each of these bytes corresponds to the top row (top dot) of that display column. The most 
significant bit (the 128’s bit) corresponds to the bottom row of dots of that display column. 


Once a display is captured by GDI SF#, each of the 132 dot-columns that make up that display can be 
handled individually, as you will see later. Bear in mind that the one-column “characters” returned by 
GOTSF# are not the same as the characters normally represented by string variables. Each of those 
“normal” characters, when displayed by a ['.I1=F statement, requires six columns of dots, and these six 
columns cannot be individually controlled. 


Displaying Graphics (20 is F') 


After a dot pattern has been created with CHARSET or captured with GUISF#, it can be displayed 
with GOISF. The characters displayed by GIISF are only one dot column wide, so GOISF allows 
more display flexibility than [11 =F, which displays characters that are six columns wide. 


LOTS [bit pattern] 





The bit pattern is the pattern of dots expressed as a string such as those that have been created with 
CHARSET# or captured by GLI SF #. This bit pattern string is always 132 characters long, where each 
character represents the bit pattern in one column of dots. If the string is other than 132 characters 
(columns) wide, it is truncated or null-filled to 132 characters. Here, “null” refers to CHE #8 °, which 
represents one column of blank dots. It does not refer to the null string. 


COISP establishes a specified dot pattern in the display, but it does not affect the display buffer, the 
storage area that holds the 96-character display line. This buffer holds the same 96-character line after 
GOITSF is executed as it did before. 
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The dot pattern displayed by G[11 SF remains in the display until the display is altered from a running 
program or from the keyboard. Among the actions that will remove a GOISP dot pattern are the 


following: 


e A character (including a space) is sent to the display. 
e One of the arrow keys is pressed ((<] (v}). 


A special feature of G[IISF is its ability to display a dot pattern in a protected section of the display. 
Once displayed, that dot pattern is immediately protected. 


Example: To see GOISF# and GOISF perform, enter and run the following M0\)1E program. When 
prompted for a string, enter any string no longer than 22 characters. Then watch. (Remember to ex- 
ecute EDL.IT MdIE before entering program lines.) 


10 DISP “The MOVIE Program” 
20 DIM D$[132],N$[132],X,S$ 
30 N$=CHR§(0) 

40 FOR X=1 TO 131 

50 N$=N$ & CHRS(0) 

60 NEXT X 

70 INPUT “ENTER STRING: ”;S$ 
80 DELAY 0,8 


90 CONTRAST 0 

100 DISP S$ 

110 D$=GDISP$ 

120 DISP 

130 CONTRAST 9 

140 FOR X=1 TO 132 


150 GDISP N$[X,132]&D$ 
160 NEXT X 
170 FOR X=1 TO 132 


180 GDISP D$[X,132] 
190 NEXT X 
200 DELAY .5,.125_ 
210 DISP TAB(8);“The End” @ 
END 





The nul! character, not the null string. 


N$ now contains 132 columns of blank dots. 


These two lines make the action of line 100 less 
visible. 


Sets up display for GDISP$’s action. 
Captures dot pattern entered at line 70. 
Clears display to enhance effect. 

Makes the show visible. 


This loop causes the message to scroll onto the 
display, one dot column at a time. 


This loop causes the message to scroll off the left 
edge of the display, one dot column at a time. 


Establishes standard delay. 
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The first time the loop comprising lines 140 to 160 runs, the 132 blank columns of dots stored in H# 
are displayed by the GDOISF statement in line 150. The second time line 150 runs, H# is displayed 
minus the left-most column of blank dots. Since GDI SF displays the specified portion of 11# combined 
with [#, the first column of dots in [1# now appears at the right edge of the display window. This is 
possible since ['# represents the 132 individual columns of dots captured by GO'ISF# in line 110. As 
the program continues to execute the loop, more and more of [1 appears. Since ['# represents the 
input string, the message entered at line 70 scrolls across the display, one dot-column after another. 


The loop comprising lines 170 to 190 eats up [1#, just as H# was in lines 140 to 160. As the loop 
continues, blank columns proceed to fill the display. 


Restricting HP-71 Use (L.f)CE) 


You can use LOCK to define a password, without which your HP-71 cannot be used. 


LUCE password 


The password can be any string expression that evaluates to no more than eight characters. It cannot 
be an unquoted string. This password must be entered exactly, without quotes, by anyone wishing to use 
your computer. Without the password, it will remain locked. 


You can execute LUCE anytime. Its execution does not turn off the HP-71 or affect its operation in 
any other way until the next time it’s turned on. When it is turned on, the display will prompt with 
Password’. Unless the password is entered correctly, without quotes, the HP-71 will turn off 
automatically. 


Once a password is assigned, the HP-71 cannot be turned on and used without it, unless the effect of 
LOCK is cancelled by entering the null string as a password, or unless you reset the memory. 


Automatic Command Execution (3 7A TUF) 


Any valid command or group of commands entered after this statement will be executed whenever the 
HP-71 is turned on. 


STAR TUF command string 





The command string can be any command or group of commands connected together with @ that can be 
executed from the keyboard. The difference is that when used with this statement, the command or 
commands must be enclosed in single or double quotes. 
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When =TARTUF is executed, the command string is not checked for correct syntax. This check does 
not occur until the HP-71 is turned on. 


To cancel such a command string, use > THF TUF with the null string or enter a new command string 
with STARTLF. 


You can control from the keyboard or from an executing program: 
¢ Scrolling speed, both horizontal and vertical. 
e Viewing angle giving best contrast. 
¢ Length of each displayed line, up to 96 characters. 
e Case of displayed letters, either uppercase or lowercase. 
Scrolling speed is controlled with DELAY, described in section 1 (page 26). Viewing angle is controlled 


with COHTEAST, also described in section 1 (page 29). Control of line length with {1 0. TH is described 
in section 13 (pages 232-233), and control of letter case is explained below. 


The L. statement not only performs the toggle function of the key ((f][LC]), but it can also 
expressly specify uppercase or lowercase. 


LA} 
Li OH 


LC OFF 





The Lt statement switches the current uppercase/lowercase state of the letter keys. No other keys are 
affected by Li. If the unshifted keys display uppercase letters (and [9]-shifted keys display lowercase) 
before this statement is executed, unshifted keys will display lowercase (and shifted keys uppercase) 
after this statement is executed, and vice versa. 


After the LC OH statement is executed, the unshifted letter keys will display lowercase letters and (9]- 
shifted letter keys will display uppercase. 


After the L. OFF statement is executed, the unshifted letter keys will display uppercase letters and 
(9]-shifted letter keys will display lowercase. 
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Overview 


Previous sections used short programs to illustrate some of the features of the HP-71. If you keyed in 
some of those programs, you might have developed a feel for how to program the computer. This section 
covers more about writing and running programs on the HP-71. More specifically, it describes how to: 


e Create a program file. 

e Enter program lines into a program file. 

e Execute a program using the key or the BASIC statements, FL! HM, GOSUB, CALL, and 
CHAIN, 

e Edit a program. 

e Locate errors in a program. 


e Interrupt a running program. 


Entering a New Program 


Entering a new program into the HP-71 from the keyboard requires two steps: 
1. Creating a new program file. 
2. Keying program lines into the file. 


A program can also be loaded from magnetic cards using the C{IF statement, as described in 
appendix C. 


Creating a New Program File (E [iI T) 


Before keying program lines into the HP-71, set the computer to BASIC mode (you can’t enter pro- 
gram lines when the HP-71 is set to CALC mode). Then, using EDIT, create a new BASIC program 
file into which the lines you enter will be stored. 


ECIT file name 


The file name is the name of the file you create. It becomes the current file and is stored in main RAM. 
If the file already exists, the HP-71 simply makes it the current file. (Refer to section 6, “File Oper- 
ations,” for more information about file names.) 
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For example, EXIT SOLE creates a file named S(iL'/E and makes it the current file. Program lines 
keyed into the HP-71 are then stored in the program file SOL‘E, 


When creating a BASIC file, you do not need to specify the file size. BASIC files automatically expand 
to accomodate new lines keyed in. File size is limited only by the amount of available RAM. 


You can also specify which memory device you want the newly created file to be in. You simply specify 
the device with the file name (as described in section 6). If a device isn’t specified, the HP-71 creates 
the file in main RAM. 


Examples: 
EQIT RADAR I Creates a BASIC file in main RAM. 
EQIT HUCLEUS:PORTCAS Creates a BASIC file in port 0. 


Using work file (HAME) 


As an alternative to creating a named program file, you can use workfile as a scratch file for 
entering program lines. To do this, make work file the current file. Also, you might want to ensure 
that workfile is empty. (Refer to section 6, “File Operations,” for more information on 
work € ile.) 


To make work file the current file, type ED. IT without specifying a file name. 


Input/Result 
Ear | Default file name is workfile. 


Displays ork ¢11¢ catalog information. If nn 
is 0, then work file is empty. The 
work £11 is now the current file. 





If nn in the above result is not 0, then work‘file has program lines in it. Before entering a new 
program into work file, you might want to save any information currently in the work file. 
You can save the information in the work file in two ways: 

1. Name the work file. 

2. Copy the woarkfile. 
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Naming the work file. You can give the work file a name using HAME. 


simplified syntax 





HAHPE new file name 


The following example shows how to save the information in work fi le using HAME. After naming 
work file, it no longer exists as wark file. You can create a new work? i l= and make it the 
current file using ELIT. 


Input/Result 
HAME PROPEL 1 Names the work file. 
EQIT Creates a new work file and designates it the 


current file. 


Copying the work file. To copy the work fi le, ensure that it is the current file then execute 
CLP’ TO destination file without specifying a source file. (The [OF statement is described in section 
6 under “Copying Files,” page 112.) After copying the work file, you might also want to clear it 
before entering new program lines. To do this, execute DELETE ALL. 


Example: 

Input/Result 

EQIT Designates the work file as the current file. 

COPY To FILE! Copies the work file toa file named FILE1 
. in main RAM. 

DELETE ALL Deletes all lines in the work file. 


Keying In a Program Line 


Program Line Format. A BASIC program line always starts with a line number and consists of one 
or more BASIC statements. A line number is an integer constant in the range 1 to 9999 that defines 
the position of a line in a program. The HP-71 keeps program lines sorted by line number; therefore, 
you can enter program lines in any order. 
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Concatenating Statements With ©. Often it is desirable to have more than one statement on a 
program line, particularly in an IF...THEH...ELSE statement (which is descibed in section 10, 
“Branching, Looping, and Conditional Execution”). Several statements can be included in a program 
line by joining (concatenating) them with the @ symbol. For example, the statements 


= 


[13 fete 
mi ye 
a 


can be written as: 


alla 


16 A = B BB = OC 


Because the two statements are on a single line, two bytes of RAM are saved. A program line with more 
than one statement is called a multistatement line. The HP-71 executes the statements in a 
multistatement line from left to night. 


Labels. Each statement in a program line can be identified by a label. Labels can be referenced in 
branching statements such as GOSUE and GOTO (described on page 179) so that program execution 
can branch to any statement in a program line. For example, in the program line: 


2o8 'THVERT': =A @ A=B @ ba 


the label IHJERT identifies the statement =A in the same way that the line number “54 identifies 
the program line. 


Labels are useful for identifying a subroutine with a meaningful name, thus helping you to remember 
what the subroutine does. As you write a program, you might want to include a branching statement 
that transfers execution to a subroutine that you haven’t written yet. Since you might not know what 
the line number of the start of the subroutine will be, you can plan to start it with a label later but 
include that label in a branching statement now. For example: 


46 GOSUB '‘RETEST' 


causes a branch to the label RETEST. This statement is said to reference the label FE TEST because it 
causes execution to branch to the statement it identifies. Including a label in lieu of a line number 
frees you from guessing at what the subroutine’s beginning line number will be. Later, when you start 
to write the subroutine, you can label its first statement using RETEST. For example: 


24H 'RETEST': IF A=E OF C=0 THEN H=0 
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When using labels, remember the following rules: 


A label can contain up to eight letters or digits and must begin with a letter. You aren’t required to 
enclose a label in single quotation marks, but the computer always adds them to labels. This makes 
it easier to distinguish labels. 


lif 'SORTi2£': FOF I=1 TO 166 SOF T12 identifies this statement. 

Where a label identifies a statement, a colon must be placed after the last character. Where a label 

references a statement no colon is used. 

36 'RETEST': IF A=B THEM B=0 RETEST identifies this statement. 

46 GOTO 'RETEST' RETEST references the statement identified by 
RETEST. 


A label can be on a line by itself. 


ize 'BLASTERS': ‘BLASTERS ': identifies a line. 

A label can be placed in a multistatement line after @. 

aah IF A=B THEH E=C 'COMPLE#1': identifies the statement 
TROMPLESL': A=AeC A=A-C. 

25 H=SITH¢CH? &@ 'GUADH' : 'SUAON': and 'SIGHH': identify different 
WeREOQCSING AS, 2669 © 'SICGHH': statements on the same line. 


S=SIGNCSIH¢HS: 


More than one label can be on a line and more than one label can identify a statement. 
$996 'CHECK': 'CHECKZ': 'CHECK': and 'CHECK2': both identify the 
IF “#8 THEH ‘'=1 same statement. This occurs, for example, when 
you consolidate two or more subroutines, but 


don’t want to change all label references to those 
subroutines. 


If you have identical labels that identify different statements in a main program or subprogram, 
the HP-71 recognizes only the first one. You can never branch to identical labels that follow the 
first one. | 


T': DESTROY A,E,C This line has the label 'START':. 

-T': DIM St25% This line also contains the label 'STAFT' :. But 
since the label already identifies a statement on 
line 10, it won’t identify the statement on line 20. 
The label '=TAHFET': on line 20 can never be 
branched to. 
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Entering a Line. To key in a program line, type a line number then one or more BASIC statements. 
The line becomes part of the program file when you press (END LINE}. (If a syntax error occurs, the line 
will not be incorporated into the program. Syntax errors are described on page 163.) 


The HP-71 interprets a line in the display as a program line when it is preceded by a line number. For 
example, 


1HA=B 

is interpreted as a program line, whereas 
A= 

is immediately executed. 


Error Checking. After you type a program line and press [END LINE], the HP-71 checks the line for 
syntax errors. Syntax errors include incorrect spelling, incorrect parameters, and improper use of a 
keyword. 
If the HP-71 does not detect a syntax error, it: 

e Enters that line as part of the program. 


e Designates that line as the current line. (The current line is described under “Viewing Program 
Lines,” page 156.) 


e Clears the display. 


If the HP-71 detects a syntax error it: 
e Does not enter the line as part of the program. 
e Beeps. 
e Displays an error message for the duration of the DELAY setting. 
e Displays the line. 
e Sets the cursor to the position in the line where the error was detected. 


If an error is detected, correct the syntax in the program line and enter it again. (Refer to “Debugging 
Operations,” page 165.) 
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Keying In Additional Lines (AUT) 


As you key in additional program lines, the size of the file expands to accommodate them. If you use up 
all available memory when entering program, the computer warns you with a message indicating that 
there is insufficient memory. 


When entering a program, it is often convenient to use the AIT statement to automatically display a 
new line number for each line you key in. You can specify both the starting line number and the 
increment to use. 


Examples: 

AUTO Starts auto line numbering beginning with line 
10, using increments of 10. 

AUTO ibe, 28 Starts auto line numbering beginning with line 


100, using increments of 20. 


Running a Program 


Executing the Current File (FUH, GOS) 


You can execute the current file by pressing [RUN]. This runs the program beginning with the lowest- 
numbered line. 


You can also run the current file by executing the F.LIH statement from the keyboard. 


simplified syntax 





RLM [line number] 


RUM [, label] 


The fine number or label represents the line or statement at which you want execution to begin. If you 
don’t specify a line number or label, execution begins at the lowest-numbered line. (If the line that you 
specify doesn’t exist, execution begins with the next highest line number. If the label that you specify 
doesn’t exist, an error results.) 


Examples: 
RUM 128 Executes the current file beginning with line 120. 
RUM J DRIVE Executes the current file beginning with the label 


DRIVE, 
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FUH executed from a program causes that program to start running at the specified line or label. Only 
the variables and arrays in the main environment remain unchanged when F'L!H is executed. (The main 
environment is described in section 12, “Subprograms and User-Defined Functions.”) 


Using the GOSLIE statement from the keyboard, you can execute the current file starting at any line 
number or label. 


simplified syntax 


GOSUB line number 
GOSUB label 
Examples: 
GOSUB 246 Executes the program in the current file begin- 
ning at line 240. 
GbOSUEB 'TERM' Executes the program in the current file begin- 


ning at the label TEFH". 


If you execute GOSUE from the keyboard, the program halts when FAUSE, STOP, END, or RETURN 
are encountered. But any statements concatenated with GOSIIE are executed only if the program ends 
with RETURH. (Executing GOSUE from a running program is described under “Branching, Looping, 
and Conditional Execution.”) Since FETIIFH ends a subroutine , you can execute a specific subroutine 
from the keyboard without running an entire program. 


Executing A Specific Program (FUH, CALL, CHATH) 


You can execute a specific program in memory (or on a mass storage medium) from the keyboard or 
from within a program. A file does not have to be the current file to execute it. However, the HP-71 
designates the program file as the current file before executing it. 


Running a Program. Using the F:LIH statement, you can execute any program file beginning at a line 
number or label that you specify. The following examples show how FL/H can be used. 
simplified syntax 


| RUE file name [, line number] 
FU file name [. label] 
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Examples: 

RUM PROGI Executes the file FF0G1 beginning with the first 
line. 

RUM TEST2:PORT¢1>, 2588 Executes the file TEST2 beginning with line 
3500. The file is in port 1. 

RUM FROGS, ACCOUHT Executes the file FF: CG2 beginning with the label 
ACCOUHT. 


Calling a Program As a Subprogram. (FALL executes a program in much the same way as FUH. 
However, when (ALL is executed, the current environment is saved and a new environment is created 
for the called program. The HP-71 treats the called program as a subprogram. (Environments and 
subprograms are described in section 12, “Subprograms and User-Defined Functions.”) 


CALL file name [: device] 


Examples: 

CALL ORBIT Executes the program file (FEIT. 

CALL APOGEE: PORT¢&3 Executes the program file HFOGEE in port 0. 
CALL Executes the current file. 


Although "ALL typically executes a subprogram, it can be used as shown to execute a program if there 
aren’t any subprograms in memory with the same name as that program. When you execute CALL, the 
HP-71 first searches for a subprogram with the specified name. If it doesn’t find a subprogram, then it 
searches memory for a program file with the specified name. If you attempt to execute a program using 
CALL and the HP-71 finds a subprogram with the specified name, that subprogram is executed rather 
than the program file you intended. 


Running Chained Programs. The CHAIN statement loads a program into main RAM from mag- 
netic cards, a mass storage device, or the computer’s memory and executes it. Before the new file is 
copied into main RAM, the current file (the one that executed CHAIN) is purged from RAM. 


CHAI file name [: device] 


"HAIN is useful when you want to execute a program that is too large to fit into memory. With 
CHAIN, you can divide a program into smaller units and execute those units one at a time. Each unit 
executes CZ HAIH as its last statement, which loads the next program and runs it. 
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For example, suppose you had a large program but had only enough memory to execute a third of the 
program at a time. Simply rewrite the program so that it can be executed in three sections, then store 
those sections separately on magnetic cards or on a mass storage device. 


FROG 1 PROGS FROG 3 


CHATH PROGS CHATIH PROG S 





As shown above, each section is stored in a separate program file. Thus if the files are called FEOG1, 
FROGS, and PROG, the last statement of FEOGi is CHAIH PROG, and the last statement of 
FROG? is CHAIH FECGS. When FROG finishes, it is purged from memory and FFEOG= is loaded 
into main RAM and executed. When FFG is finished, it is purged and FFOG3 is copied into main 
RAM and executed. 


While HAIN is used primarily for executing a succession of files on magnetic cards or a mass storage 
device, it can be used to execute programs stored in the HP-71 memory. (For more information about 
using HAiIH with files on magnetic cards, refer to appendix C.) 


Interrupting a Program 


When a program has finished its task, it normally stops running. A program can also stop running for 
other reasons. For example, when the HP-71 detects an error in a running program (that is, the HP-71 
can’t perform some operation), it stops the program and reports the error. 


You can also halt a program before it is finished. You can do this from the keyboard or include an 
instruction in the program which causes it to halt. 


You might want to halt a program when it doesn’t seem to be operating properly or you might want to 
view the values of some variables. You might also halt a program when you are locating and correcting 
its errors (debugging). 
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A halted program can assume one of two states: 


e Suspended. The SUSP annunciator is on, indicating that the program can be continued from where 
it halted. All program control information remains intact. 


e Ended. The SUSP annunciator does not come on, indicating that all program control information 
is erased. The program cannot be continued. 


A program becomes suspended when you press [ATTN], it executes FALISE, or an error occurs. 


Halting Execution From the Keyboard 


Suspending a Program. To halt a running program from the keyboard so that it maintains a sus- 
pended state, press [ATIN]. When you do this, the HP-71 displays the SUSP annunciator, indicating 
that the program can be continued from where it halted. (The statement at which execution can con- 
tinue is called the suspend statement.) 


The HP-71 retains the environments existing at the time a program is suspended. (Environments are 
described in section 12, “Subprograms and User-Defined Functions.”) While a program is suspended, 
you can perform the following operations on the HP-71 without affecting the program’s suspended 
state: 


e Display and alter variables. 

e Perform keyboard calculations in BASIC or CALC mode. 

e View the contents of the current file. 

« Copy files. 

e Obtain catalog listings. 

e Turn the HP-71 off and on. 

e Call a subprogram. (However, a subprogram may change the global environment. This 


occurs, for example, if the subprogram contains a DELAY‘ state- 
ment.) For more information, see section 12. 


Generally, operations that don’t alter the current file or designate another file as the current file don’t 
affect the suspended state of a program. Operations that affect the suspended state of a program are 
described below under “Ending a Program.” 


When you want to continue executing a suspended program, either press [f][{CONT] or execute ZOHT. 
Execution will resume at the suspend statement, which is the statement following the last statement 
executed. If you want to view the suspend statement, execute FET(:H from the keyboard. 


In some infrequent situations, a running program might not halt when you press [ATTN]. If this occurs, 
press simultaneously, then select level 1. (Refer to “Verifying Proper Operation,” page 273.) 
When you use to interrupt the HP-71, it ends the program and might do a memory reset. You 
should therefore avoid using this unless you haven’t been able to gain control of the HP-71. 
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Ending a Program. The following statements and operations end a program, clearing its suspended 
state: 


e EDIT. 

e EHO, EHO ALL, STOF.* 

e MELETE. 

MERGE (a BASIC file). 

e FUFGE (the current file). 

e FREE FORT, CLAIM PORT. 
e TEAHFORM (the current file). 
e RUM, CHATH., 


e Altering a program line. 


After ending a program, there is no way to restore its suspended state. 


Halting Execution From Within a Program (FHUSE, WAIT, TOP, EMD) 


Suspending a Program. A program suspends itself when it executes FAUSE. FAUSE uses no param- 
eters, so it appears simply as 


When a program executes this statement, it halts as if were pressed. The current line is the line 
containing the statement following FAUSE. If you want program execution to continue, press [f]{[CONT] 
or execute CCIHT (described below under “Resuming Program Execution”). 


To enable a user to view intermediate results that a program might produce, you can use HAIT. 


WAIT seconds 


WAIT causes a program to do nothing for the specified number of seconds. Any information in the 
display remains there while the statement is executing. HIT does not suspend a program. 


* However, if the program was suspended while executing a subprogram, then executing EHD or STUF ends the subprogram only, 
and the program remains in a suspended state. EH{! ALL ends all levels of subprograms and the main program. (For more 
information about subprograms, refer to section 12, “Subprograms and User-Defined Functions.”) 
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Ending a Program. You can end program execution with the =TOF and EHL! statements.* 


EHO 


Both statements end a program and clear all memory associated with program control. Athough they 
are often the last statements in a program, STOF and END can be anywhere in a program. 


Resuming Program Execution ((f][CONT], COHT) 


Whenever the SUSP annunciator is on, you know that the program in the current file has been sus- 
pended. You can resume execution by pressing [f][CONT] or by executing COHT. Execution resumes at 
the suspend statement. 


Pressing (f][CONT]. Program execution can be resumed from where it was suspended (the suspend 
statement) by pressing [f][CONT], but only if the SUSP annunciator is on. If the SUSP annunciator is 
off, pressing [f ][ CONT] executes the current file beginning with the lowest-numbered line. (This is equiv- 
alent to pressing [RUN J.) 


Note: You can’t resume program execution by pressing or executing FLUM. RUM clears the 
program control information and restarts the program. 


Executing COHT. The COHT statement gives you more flexibility with how you resume program ex- 
ecution. With COHT you can specify the line number or label at which program execution resumes. 


Examples: 
COHT lee Resumes program execution at line 100. 
CONT 'PHASEL' Resumes program execution at the label 


Poe h. 


You can execute TMT from the keyboard only. 0HT is not programmable. 


*If a program is executing a subprogram, then executing STOF or EHO ends the subprogram only. To end a program from a 
subprogram, execute EHC! ALL. However, since this decreases the usefulness of a subprogram, using END ALL in a subprogram 
is not recommended. (For more information about subprograms, refer to section 12, “Subprograms and User-Defined 
Functions.”) 
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If a line number or a label is not specified, program execution resumes at the suspend statement. If you 
execute CONT for a program that isn’t suspended, the program in the current file will be run as if FUN 
were executed. 


Editing a Program 


Editing a program file usually consists of a combination of the following operations: 
e Viewing selected program lines. 
e Adding lines. 
e Changing existing lines. 
e Deleting lines. 
e Renumbering program lines. 


Before attempting to edit a file, be sure the computer is set to BASIC mode and the file you want to 
edit is the current file. 


To edit a program file that is not the current file, use: 


EQIT [file name] 


If you don’t specify a file name, the HP-71 designates the work file as the current file. 


Viewing Program Lines (FETCH, LIST, PLIST, GOTO) 


Scrolling Through a Program. You can use the [A], [V], (9][A], and (9][y] keys to display the 
program lines in a BASIC file. 


Since you can view only one line at a time on the HP-71, the HP-71 designates that line as the current 
line. You can view the current line by executing FETCH (as described below). 


To display the line previous to the current line, press [A]. To display the line following the current line, 
press [¥]. The new line displayed becomes the current line. You can use these keys to scroll] through a 
file one line at a time. Pressing or continuously causes program lines to be momentarily dis- 
played in ascending or descending order. 


To view the first line of the program file, press [9][Z]. To view the last line of the program file, press 
(9)Ly). 
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Fetching a Line. You can view a specific program line using FETCH. It has the general form: 


FETCH [line number] 


FETCH [label] 





You can specify either a /ine number or a label. If a label is specified, it can be quoted or unquoted. You 
can display the current line by not specifying either. 


Examples: 

FETCH Displays the current line. 

FETCH 188 Displays line 100. 

FETCH GRAPH Displays the line containing the label GRAFH. 
FETCH "SORT" Displays the line containing the label 20FT1. 
FETCH AF Displays the line containing the label indicated 


by H#. 


Listing a File. A program file can be listed using the LIST and FLIST statements. If the HP-71 is 
connected to a printer, FI =T lists the specified program on the printer, otherwise it lists lines on the 
HP-71 display.* 


simplified syntax — A 


LIST [start line number] [,. end line number] 
LIST file name [, start line number [,. end line number]] 


simplified syntax 
FLIST [start line number] [. end line number] | 


| 
FLIST file name [. start line number [, end line number}] | 








LIST and FLI5T list program lines in ascending order. 


Executing LI5T without specifying parameters lists the current file from the first to the last line. If 
the file you specify isn’t found, the HP-71 responds with the error message: 





* The HP 82401A HP-IL Interface is required to connect a printer to the HP-71. 
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Changing the Current Line Designation. Using the GT statement from the keyboard, you can 
designate a line as the current line without displaying it. 


| GOTO line number 
TC label 


When you execute TO you can specify either a /ine number or a label. A label can be quoted or 
unquoted. 


Examples: 

GOTO 1e@e Designates line 100 as the current line. 

GOTO VWALEWCE Designates the line containing the label 
WALEMCE as the current line. 

GOTO "RESET" Designates the line containing the label FESET 


as the current line. 


Adding a Line 


A line can be added to a program by typing a program line containing one or more statements, then 
pressing [END LINE]. This is no different from keying in the original program. If you add a program line 
that has the same line number as a program line already in the file, the new line replaces the old one. 
Two program lines cannot have the same line number. 


Editing Existing Lines 


To edit an existing program line, first call that line to the display (using FETCH, [a], [v], [9][A], or 
(S][V] as described above), change it as you wish and press (END LINE]. Remember that after editing a 
line, you must press to enter that edited line into the program. (Pressing [a], (v], (9)[A], or 
(9][ Vv] after editing a line will not enter that changed line into the program.) 


Deleting Lines (QELETE) 


One or more program lines can be erased from the current file using DELETE. To use this statement to 
delete: 


e A single line, type: 


CKiELETE line number 


e A block of lines, type: 


NELETE first line number, last line number 
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e All lines in the file, type: 


UELe. Ve: ALG 


If you execute DELETE ALL, the file will still be in memory, but it will be empty. If you would rather 
purge the current file from memory, execute PURGE. 


You can also delete a single program line by typing the line number you want to delete and pressing 


END LINE]. For example, 
1 | END LINE 


deletes line 50 from the current file. 


Renumbering Lines (FEHUMBEF) 


Often after adding, deleting, and changing program lines, the intervals between program line numbers 
can be too small to allow much additional editing of the program. For example, you cannot add a line 
between lines 10 and 11 in a BASIC program. To remedy this inconvenience, you would have to renum- 
ber one or more program lines to make room for a new line. But, when you change a line number, you 


need to ensure that you change all references to that line (such as GOTO, GOSUE, and 
FRIHT USING statements). If you are changing many program line numbers, this task can become 
large. 


The HP-71’s RENUMEEF: statement can do all this for you. It renumbers the current file using param- 
eters that you can specify. 





REMUMBER [new start line [. increment [, old start line [. old end line]]]] 


In the syntax description above, new start line is the new starting line number, increment is the desired 
increment value between successive line numbers, o/d start line is the number of the line that you want 
renumbering to begin at, and old end line is the last line that you want renumbered. 


Examples: 


FEMUMBER Renumbers the current file so that its first line 
number is 10 and all succeeding lines are num- 
bered in increments of 10 (default). 


REWMUMBER lee, 2A Renumbers the current file so that its first line 
number is 100 and succeeding lines are num- 
bered in increments of 20. 


REHUMBER 188,108,288, 2868 Renumbers lines 200 through 300 so that line 200 


becomes line 100 and succeeding lines are num- 
bered in increments of 10. 
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Using BIN and LEX Files 


The HP-71 has a large number of statements, functions, and operators which you can use. Also, you 
can write and run your own BASIC programs. In addition to this, you can extend the capabilities of the 
HP-71 by using BIN and LEX files. These files are specially coded files. BIN programs run faster than 
comparable BASIC programs and LEX files add keywords to the computer. 


Binary Programs 


Binary programs are specially coded program files which can be executed like BASIC programs. ‘Typi- 
cally, you obtain a BIN file by copying it from the card reader or a mass storage device. Or, it can be 
contained in a plug-in ROM module. 


You execute a BIN file in the same way you would a BASIC file; that is, using FUM, CHATH, or CALL. 
BIN files don’t have line numbers or labels, so you can’t execute one with GOSUE. 


Since BIN files are specially coded programs; they can’t be edited. You can only execute them. 


Language Extension Files 


Language Extension Files (LEX) are special binary files which add BASIC keywords to the HP-71. 
They are typically found in application pacs and plug-in extensions or modules. You can’t execute or 
edit a LEX file. A LEX file doesn’t have to be the current file to be used. When the file is in the 
computer’s memory (RAM or ROM), you can use its keywords. 


You can use the BASIC keywords in a LEX file as you would any other keyword. The documentation 
supplied with a LEX file explains the proper syntax and usage of the file’s keywords. 


When you execute a BASIC program containing LEX file keywords, that LEX file must be present in 
memory. 


Transforming Files (7 filicor ORM) 


The TEAHSFORM statement can be used to change a BASIC program into a TEXT file so that it can 
be transferred to another Hewlett-Packard computer. 






simplified syntax 
TRAN SFORM [[file name]: device] ItHT0 file type [file name [: device]] 


TRANSFORM can also change a TEXT file into a BASIC program file. A TEXT file transformed from 
a BASIC file has one record for each program line. (The TRAHSFUFM statement is described in more 
detail in the HP-71 Reference Manual.) 
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Examples: | 

TRAHSFORM FPROGLi IHTO TEXT Transforms the BASIC program file FF.OG1 
TPROGLi:PORTC&3 into the TEXT file TFFOGi in port 0. 

TREAHSFORM TRPREOGL:PORTC&3 Transforms the TEXT file TFEOG1 in port 0 
IHTO BASIC into a BASIC file. 


This statement is particularly useful when you want to use programs on the HP-71 that were written 
for the HP-75. It enables you to translate programs from the HP-75 to the HP-71. 


The HP-71 TEXT file uses the Hewlett-Packard Logical Interchange Format, type 1 (LIF1). The LIF1 
format is common to several HP computers and is therefore used for interchanging information be- 
tween computers. HP-75 files that are of type LIF1 can be loaded into the HP-71 using the optional 
HP 82400A Magnetic Card Reader. (The operation of the card reader is described in appendix C.) A 
BASIC program file can be transformed into a TEXT (LIF1) file on one computer, stored on a mag- 
netic card, then loaded into the other computer, where it can be transformed back into a BASIC file. 


Example: Transform a BASIC file on the HP-75 into a LIF1 file, record it on a magnetic card, then 
transfer it to the HP-71: 


On the HP-75: 

transform ‘pragi' inte lifl Transforms a BASIC file on the HP-75 into a 
LIF 1 file. 

copy ‘progi! to card Copies the transformed file onto a magnetic card 
using the HP-75 built-in card reader. 

On the HP-71: 

LOFY CARD To PRoGi Copies the card into the TEXT file FEMG1. 

TRAHSFORM FPROGL IHTO BASIC Transforms FF:01 into a BASIC program file. 


Note: A TEXT file can be transformed into a BASIC file only if each record (line) begins with a valid 
BASIC line number. While the HP-75 accepts the line number 0, the HP-71 does not. If the HP-71 
attempts to transform a file containing a line number 0, it will generate an error and will not com- 
plete the transformation. You should therefore ensure that any HP-75 program file that you intend 
to transform not contain the line number 0. 


When you transform a TEXT file that was written on a card by the HP-75, the HP-71 changes any 
program line it can’t interpret into a remark. That is, after the line number a ! 7% is inserted in a line 
which could not be properly interpreted. You then need to rewrite the line to conform to HP-71 BASIC. 
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Error Conditions 
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Overview 


This section covers the following topics: 





Types of errors. 

How the HP-71 notifies you of errors. 

How to respond to error and warning messages. 
How to locate and correct errors. 


How a program can handle its own errors. 
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Types of Errors 


When writing a program, performing keyboard operations, or running a program, you might encounter 
error messages or warning messages. An error message indicates that an operation can’t be performed 
until you correct an error. A warning message indicates that either the computer used a default value as 
the result of an operation or that a certain condition requires your attention. 
You can encounter three types of errors on the HP-71: 

e Syntax 

e Run-time 

e Logical 
A syntax error is an error in a statement’s construction. This includes such errors as misspellings and 


improper parameters. The HP-71 checks for syntax errors as statements are entered from the key- 
board. 


A run-time error is an error that is detected when a statement is being executed. Run-time errors occur 
for events such as invalid arguments supplied for functions and branches to nonexistent lines. A logical 
error is an error in a program’s design. This type of error occurs when a program fails to produce the 
correct results. The HP-71 doesn’t detect logical errors; however, it does have functions that enable you 
to trace such errors. 


Error Messages 


The HP-71 displays an error message when it can’t correctly perform an operation. It also suspends its 
operations (either keyboard or program operations). An error message indicates the nature of an error 
and, in the case of a running program, the line in which the error was detected. 


Messages for Syntax Errors 


When the HP-71 detects a syntax error, it: 
e Rejects the line just entered. 
e Sets ERRH (described on page 173). 
e Beeps and momentarily displays an error message (according to DELAY setting). 
e Displays the line just entered. 


e Sets the cursor to the point in the line where it detected the error. 
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A syntax error message has the form: 
ERF : message 


Example: 


FRE: Invalid Expr Indicates that an expression was keyed in 
incorrectly. 


If, after the HP-71 reports an error, you find that the message doesn’t aid you in determining why the 
error occurred, refer to “Errors, Warnings, and System Messages” in the HP-71 Reference Manual. The 
reference manual lists the most common reasons why each error occurs. 


Messages for Run-Time Errors ((9][ERRM])) 


When a run-time error occurs, the computer: 
e Halts execution (if detected in a running program, it suspends the program). 
e Sets ERFL and EFRH (described under “Program Control of Errors,” page 171). 


e Beeps and displays a message. 


A run-time error message has the general forms: 


EFF: message For a statement executed from the keyboard. 


EFF Ln: message 


where EF‘F: indicates that this is an error message, Ln indicates the line number, n, at which the error 
was detected and message indicates what caused the error. 


For a statement executed from a running program. 





Example: 


ERE L38:String Ovel Indicates that a statement on line 30 of a program 
attempted to assign a string to a string variable 
that didn’t have a large enough dimension. 





You can view the last reported error or warning message by pressing [9][ERRM] or executing ERFI(#. 
For an example, key in the following: 
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Input/Result 
DIM AFCS I Dimensions the string variable, A #, to five 
characters. 
AF="TOO BIG" Attempts to assign a seven-character string to Af. 
EER: String Ov The computer beeps, then displays a message in- 





dicating that the string assigned to A¥# is too 
large. 


(9J[ERRM) (hold down) Displays most recent message. 


String Ow] 





EREMS Displays EFF, which returns the most recent 
message. 


String Ov] 





Debugging Operations 


Error messages are very concise and usually easy to interpret. If you need more information about an 
error, refer to “Errors, Warnings, and System Messages” in the HP-71 Reference Manual. That section 
contains a list of HP-71 error messages and the most common error conditions associated with them. 
You may also want to refer to “HP-71 Keyword Dictionary” in the reference manual for more informa- 
tion about the proper syntax and use of HP-71 keywords. 


If you can’t determine the cause of an error after referring to the reference manual, you can use 
TRACE and to trace program execution. 
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Tracing Execution (TRACE FLOM) 


A useful method of locating errors is to trace program branching using TEACE FLOW. To trace pro- 
gram flow, execute TRACE FLOL from the keyboard, then execute the program. (This statement can 
also be executed by a program, but it can’t be executed from the keyboard while a program is running.) 


TRACE FLOW 


When you trace program execution, the HP-71 displays a message showing you each branch that oc- 
curs. (Refer to the next section, “Branching, Looping, and Conditional Execution” for more informa- 
tion about branching.) 


This message has the form: 
Trace line line number to line number 


If the order of program execution were to proceed sequentially from the lowest-numbered line to the 
highest, trace messages wouldn’t be displayed. But when a branch occurs (including a subprogram call), 
the HP-71 displays both the line number where the branch occurs and the line number to which execu- 
tion branches. 


Example: 





A branch to a subprogram is reported in the form: 
Trace Line line number CHLL subprogram name 
and a return from a subprogram is reported in the form: 
Trace line line number EMHOSUE 


Example: A program has a call on line 100 to the subprogram TEST 1. The subprogram begins at line 
400 and ends at line 450. 


ige CALL TESTI 


i eee 
oqsee 
rs 


SUB. esd 


wdfecs 
LTE one 
mt 


EHO SUE 
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As the computer executes these lines, it displays: 


LALL TESTI Reports the branch to the subprogram TET 1. 


EMOSUE Reports the return back to the calling program. 





Tracing Variable Assignments (TRACE ARS) 


The TRACE ARS statement enables you to trace the value changes of variables in a running pro- 
gram. It can be in effect concurrently with TRACE FLOM. 


When a program assigns a value to a variable, the HP-71 displays a trace message indicating the line 
number where the assignment took place and: 


e The name and assigned value of a simple numeric variable. 





TRACE VARS enables you to pinpoint where variables are being assigned unacceptable values. 
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Cancelling Trace Operations (TF ACE UFF) 


Trace operations are cancelled by executing TRACE OFF. 





This will cancel a TEACE WAFS anda TEACE FLOM condition. It can be executed from the key- 
board or by a program. It can’t be executed from the keyboard while a program is running. 


Single-Step Execution ((f][SST}) 


The function enables you to execute a program one line at a time and view the result of each 
operation. You can evaluate each step of a program to determine where and why logical and run-time 
errors occur. 


performs two functions: 

e It displays the next statement to be executed when you press [f][ SST}. 

e It executes the statement when you release [SST]. 
Example: Key in a program that displays the letters of the alphabet one at a time, then single-step 
through it. (Before using [SST], ensure that the program you want to debug is the current file and that 


the HP-71 is in BASIC mode.) As you single-step through the program, view some intermediate results 
to verify that they are correct. 


Input/Result 

i6 FOR I=65 To 936 Beginning of loop. 
2a CHRECT> Displays a character. 
20 HERT I End of loop. 

(hold) 


Displays first line as long as you hold [SST]. (You 
don’t need to hold the [f] key.) 





(release) 


(hold) 


OLSF 


CHR#E¢ 7 3 





(release) 


T [END LINE] 


OISP 


CHRECI 3 


(release) 
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Executes the line. 


Displays cursor and SUSP annunciator. 


Displays the line. 


Executes the line. 


Displays character 65. 


What is value of increment counter? (While sin- 
gle-stepping through a file, you can perform key- 
board operations.) 


I equals 65 (the character code for Fi). 


Displays and executes next line. 


Because this is a loop, execution jumps back to 


line 20. 


Displays next character. 
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I [END LINE What is value of increment counter? 
GE suse | Character code for B. 


Lt )LCONT} Completes program execution. 


You can continue single-stepping through the program until it ends. As an alternative, you can press 
(shown above) to execute the remainder of the program. 


When you single-step through a program, the HP-71 displays and executes one statement at a time. If 
you execute a multi-statement line using [f][SST], each statement is shown with its bounding concat- 
enation symbols (i), and then executed. 


Example: Change line 20 of the program from the example above to display the character code, its 
uppercase equivalent, then the lowercase counterpart. Then, single-step through the program. 


Input/Result 
2G I @ CHRE¢I> @ CHRE¢1+323 Changes line 20 (from previous example). 
[#)LSst) (hold) Displays first line. 





(release) Executes statement and suspends program. Com- 
puter displays SUSP annunciator. 
(hold) | Displays next statement. 


The @ indicates that there is another statement 
on the same line. 





(release) Executes the statement. 


Ty 
LF 


susp Displays the value of I. 
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[t]LSST] (hold) Displays next statement on the line. 


2eH@ OISF CHRE¢Is The first indicates that a statement precedes 
the one displayed and the second @ indicates that 
another statement follows on the same line. 





(release) Executes the statement. 


“Ii 


susp Displays a character. 


(t}(SST] (hold) Displays last statement in line. 


208 DISF CHRECI+323 





(release) Executes the statement. 
[éJLCONT ] Continues program execution. 


For longer programs, you might want to single-step through a few lines only. You can set the HP-71 to 
the line or label that you want to begin single-stepping at by executing GOTO from the keyboard. The 
line you specify or the line containing the label you specify becomes the current line. 


You can also single-step through a suspended program. Pressing and releasing executes the 
suspend statement. This is useful when you want to execute a program, but single-step through a por- 
tion of it. To do this, include a FALSE statement at the beginning of the portion of the program that 
you want to single-step through, then run the program. When the program executes the FALISE state- 
ment, the HP-71 suspends the program. You can single-step through the program at that point. 


The TRACE WARS and TRACE FLOM conditions can be active during single-step execution through 
a program. 


Program Control of Errors 


Normally when a run-time error occurs, the HP-71 halts program execution and displays a message. 
However, you might not want a program to halt for certain errors if you anticipate them. Rather, it 
might be better if you could write a recovery routine that would process anticipated errors. When an 
error occurs, program execution would branch to your recovery routine and continue to run uninter- 
rupted. The HP-71 has several statements that enable you to write and use error recovery routines. 
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Branching on an Error (GH ERROR, OFF ERROR) 


The GH ERFROE statement causes a branch to a specified program line when an error occurs. This can 
be used to implement an error recovery routine. 


The two forms of GH ERRUE are: 
simplified syntax 


NH ERROR GOTO line number 
OH ERROR GOTO label 


simplified syntax 


OH ERROR GoOSUB line number 
TH ERROR GOSUE label 


CH ERROR GOTO causes a branch to another statement. 0H ERROR GOSUE causes a branch to a 
subroutine. When the subroutine is completed, execution returns to the statement following the one in 
which the error occurred. 


When UH ERROF is executed, an OH ERROR condition is created which exists until it is explicitly 
turned off, changed, or the program ends.* To change an UH ERFROF condition, simply execute 
OH ERROR again. 


To turn off an OH ERROF condition, execute 


NFF ERROR 





No error branching will occur unless OH ERRUF is again executed. 


*The OH ERROR condition is not global. If it is set in a main program, it will not exist for any subprograms. If it is set in a 
subprogram, it won’t exist for the main program or any other subprogram. Refer to section 11, “Subroutines, Subprograms, and 
User-Defined Functions.” 
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Determining an Error Message Number (EFF) 


Each HP-71 error message has a unique identification number. (The identification numbers for error 
messages are listed under “Error, Warning, and System Messages” in the HP-71 Reference Manual.) 
Error messages are grouped so that numbers for similar types of messages fall within a range. For 
example, the identification numbers for the math error messages range from 1 to 21. 


In some applications, a program might need to determine the type of error most recently committed. It 
can do this using EF FH. 


EF RH returns the identification number of the most recent error message. 


Example: Generate an error, then determine the message number. 


Input/Result 
DEFAWLT OFF Treats math exceptions as errors. 
LOGe-53 Executes a function using an invalid argument to 


generate an error. 


EF RH Gets the number of the message. 


Pe Displays the number of the most recent message. 


If you know beforehand which errors you want to process in an error recovery routine, you can test for 
their identification numbers to determine which operations to perform. 


Example: Write a program that displays the square of the natural log of a number which is input 
from the keyboard. Include in this program an error recovery routine which processes a negative or zero 
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10 DEFAULT OFF @ DESTROY N Treats all error conditions as errors. 
20 INPUT “SQUARE LOG OF ?°; N Inputs a number. 
30 ON ERROR GOSUB 70 Branches to line 70 on an error. 
40 DISP LOG(N)*2 Calculates and displays the square of the log of n. 
50 OFF ERROR Turns off the OH ERRGF condition. 
60 GOTO 20 Loops back to input another number. 
70 IF ERRN=12 THEN DISP “CAN’T TAKE 0” _— Displays message if error number is 12. 
80 IF ERRN=13 THEN DISP “CAN’T TAKE Displays message if error number is 18. 
NEG” 
90 RETURN 


EF:F:H also indicates the type of device, plug-in ROM, or LEX file which generated the error message.* 
Message numbers are of the general format 


iimmm 


where iii is a three digit LEX identification number and mmm is a message identification number. Any 
leading zeros in this number are suppressed. For example, EF FH returns only a message ID number for 
errors generated by the computer because it has a LEX ID of zero. 


The LEX ID number identifies the device or LEX file that generated an error. The owner’s manual for 
each plug-in device or ROM indicates its LEX ID number. 


For example, the HP 82401A HP-IL Interface has a LEX ID of 255 and can generate its own error 
messages. If you are using the HP-IL interface and commit error number 7 according to this module, 
EF FM will return the value 255007. The three leading digits (255) indicate that the device is the HP-IL 
interface. The three trailing digits indicate that the message number is 7. 


* A LEX file is a Language Extension File, which is a binary program that adds keywords to the HP-71. LEX files can be in user 
memory or a plug-in extension. For more information about LEX files, refer to section 8, “Writing and Running Programs.” 
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Recalling an Error Message ((9][ERRM], ERE M#) 


Some applications require that an error message be saved, or combined with other messages and dis- 
played. To save or manipulate a message, you need to recall it. You can recall the HP-71’s error mes- 
sages in two ways: 


« Press and hold (9][ERRM]. This displays the most recent error message. 


e Execute ER RM. This returns an error message in a string expression. 


EREM = 


ERM is useful for customizing error recovery routines. For example, program execution can branch 
on an error to a routine that assigns the error message to a string variable, adds to the variable, then 
displays it as a custom error message. 


Locating an Error (EF:F'L) 


You can determine the program line at which the most recent error occurred (if it occurred in a running 
program) by executing EF FL. This function always returns a line number. For example, if an error 
occurred at line 50 of your program, the statement 


DOISPF "Error an line": ERRL 


would display 


Error on line 38 





Warnings 


Warning messages indicate conditions which are not significant enough to halt program execution, but 
can be accommodated automatically by the HP-71. These include warnings about the condition of the 
batteries, card reader information, file information, and warnings about math overflows and 
underflows (these are described under “Math Exceptions In Programs” below). 
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When a warning occurs, the HP-71: 


1. Sets EFFH to the number of the warning message. If the warning occurred during a running pro- 
gram, EFFL is also set. 


2. Displays the line number (if a running program) and message accompanied by a beep. For example: 





The message remains in the display for a length of time specified by the DELAY’ setting. 


3. Substitutes a default value and resumes execution. (You can select which default values are used 
for some expressions. Refer to “Math Exceptions,” below.) 


The display of warnings is not affected by an (1H ERFOF condition. That is, OH ERROR branching 
can’t occur for a warning condition. 


You can suppress the display of warning messages by setting flag —1. (Refer to section 10, “Flags,” for 
information on setting and clearing flags.) When this flag is set, the computer supplies a default value 
for an expression that causes a warning. The HP-71 will not display a warning message or set EF FL or 
EF FH, so you will have no indication that a warning has occurred. This is useful when you don’t want 
a warning to interrupt program execution. 


Math Exceptions In Programs 


Exceptions as Errors 


Math exceptions are error conditions which can be treated as either errors or warnings. (Math excep- 
tions are also described in section 2.) Math exceptions are associated with the five math exception 
flags. When a math exception flag has a corresponding trap value of 0, the exception associated with 
that flag will be treated as an error. When the exception occurs: 


e Execution halts and the computer displays an error message, or 


e If OH ERROR was executed, program execution will branch to the line specified in the 
OH ERROR statement. 
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Exceptions as Warnings 


If an exception has a trap value of 1 or 2, it generally will be treated as a warning (as described above 
under “Warnings”), and a default value will be provided in the expression that caused the exception.* 
The default value supplied depends on the trap value. 


In many applications, you might choose to have math exceptions treated as warnings. If so, expressions 
that generate math exceptions will assume the default values that you select. Since you would antici- 
pate this, you might not want warning messages displayed. To suppress the display of most warning 
messages (including those for math exceptions), execute 


SFLAG -1 
Most warning messages won’t be displayed until you execute 
CFLAG -1 


(For more information about these statements, refer to section 11 “Flags.”) 


eee 
* An exception to this is the I VL exception flag. When the trap value for I\!L is 1, then an IVIL exception will be treated as an 
error. For more information about math exceptions, refer to “Math Exceptions” in section 2. 
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Branching, Looping, and Conditional Execution 
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Overview 


The HP-71 has several branching and looping statements that allow you to control the order in which 
program statements are executed. 
More specifically, this section describes: 

e Unconditional branching. 

e Multiple branching. 

e Timer branching. 

e Looping. 


e Conditional execution. 


Another type of branching—error branching—is discussed in section 9, “Error Conditions.” 
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Unconditional Branching 


Branching to a Program Line or Label (GOTO, GOSUE, FETURH » POF) 
The GOTO statement causes program execution to branch to a specified line or a label. 
simplified syntax 


OTC line number 
LOT label 


Branching with GOTO is unconditional because the branch occurs every time the statement is ex- 
ecuted. GCITO can’t cause a branch to a user-defined function or a subprogram. (Branching to 
subprograms and user-defined functions is described in section 12.) 


The GOSU6 statement causes an unconditional branch to a subroutine. The HP-71 saves the location 


of each GOSLIE statement it executes so that when a subroutine ends (with FETUFH), execution re- 
turns to the statement following the GOSUE that called it. 


simplified syntax 


GOSUE line number 
GCOSUE label 
As with GOTO, the GOSUEB statement can’t cause a branch to a subprogram or a user-defined function. 


The FETLIFRH statement marks the end of a subroutine and directs the HP-71 to resume execution 
with the statement following the last GOSUE executed. 


A subroutine can contain a GSE which causes a branch to another subroutine. When aFETUEN is 
encountered, execution branches back to the statement following the OSU in the first subroutine. 
When another RETUFH is encountered, execution returns to the statement following the original 


GOSUE. Thus, subroutines can cause branches to other subroutines. When this occurs, the subroutines 
are said to be nested. The amount of nesting that can occur is limited only by the size of main RAM. 


Nested subroutines typically end in the reverse of the order in which they were branched to. That is, 
the last subroutine branched to is the first one to end when a FETLPRHM statement is executed. 


For some special applications, the order in which nested subroutines end can be changed by FOF. 
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Whenever a branch to a subroutine occurs, the HP-71 saves the location of the GO SUE statement that 
caused the branching. If you execute F'OF, the location of the last GOSUE that caused a branch is no 
longer saved. In this way, the return to a subroutine level can be bypassed. 


Branching to a Subprogram (HLL) 


With the CALL statement, program execution can branch to a subprogram (or another program) and, 
upon completion, return to the statement following the calling statement. 


simplified syntax 


CALL subprogram name [* parameters : ] 





This statement is similar to GOSLE in that execution returns to the statement following the CALL 


when the subprogram has ended. The difference between the two statements is that GOSUE causes a 
branch to a subroutine while {ALL causes a branch to a subprogram. Also, CALL can transfer execu- 
tion to a subprogram located in a file other than the current file. 


Writing and using subprograms is described in section 12, “Subprograms and User-Defined Functions.” 


Branching to Another Program ((0HH If) 


You can unconditionally branch to another program file using the CHAIN statement. 


simplified syntax 


CHAIH file name 





The CHA IH statement purges the current file from RAM, copies the chained file into main RAM, then 
executes it. The chained file becomes the current file. The program to be chained can be located in the 
computer’s memory or, more commonly, in an external device such as the magnetic card reader or a 
digital cassette drive. 


Note: Since CHA IH purges the program that executes it, don’t use your only copy of a program 
to execute this statement! 


Using CHAIH, a prograrh which is too large to fit in HP-71 memory can be divided into smaller pro- 
grams and stored on a mass storage medium as separate files. After completing execution, each smaller 
program chains the next one. 
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CHAIH preserves the status of al] variables, modes, traps, flags, and open data files from one program 
to the next. However, it releases all local environments and program control information. (Program 
environments are described in the section 12, “Subprograms and User-Defined Functions.”) When a 
program is chained, it begins running at its lowest-numbered line. 


Examples: 

CHAIH MAILIST Chains a program, MHILIST, starting execution 
with the lowest-numbered line. 

CHAIW MAILIST: CARD Chains MAILI‘ST from the magnetic card reader. 

Multiple Branching (2... ST O, OA... GOSUB) 


The OH... GOSUE and OH... GOTO statements provide multiple branching capability based on the 
value of a numeric expression. 


simplified syntax 


UM expression GOTO line number, line number... 


label label 
simplified syntax 
UH expression GOSUE line number, line number... 
label label 


When either of these statements is encountered in a program, the computer evaluates the numeric 
expression and rounds the value to an integer. That integer points to one of the line numbers or labels 
following the GOTO or GOSUB. If the expression evaluates to 1, program execution branches to the 
statement indicated by the first line number or label listed after the GOTO or GOSUE. If the expres- 
sion evaluates to 2, execution branches to the statement indicated by the second line number or label 


in the list, and so on. 


Example: The following statement causes program execution to branch on the value of the expression 
(THZ9+0AR=2 0 41. 


UH CTS234+€AH=234+1 GOTO FIRST, eH, LAST 


If {T=25+¢A=22+41 evaluates to 1, then execution branches to the label F IFT. If the expression 
evaluates to 2, then execution branches to line 200. If it evaluates to 3, a branch to the label | AT 
occurs. 
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Timer Branching 


The HP-71 has three program timers which can be set to interrupt a program and cause execution to 
branch to another line or label. A common application of program timers is to run entire routines at 
specified intervals. With the OH TIMER #...G05UE6 and OW TIMER #... GOTO statements, 
synchronized branches to a subroutine or simply another part of the program can be accomplished. 


Timer Branching With GOTO (QOH TIMER #...0G0TO) 


The OH TIMER #... GOTO statement transfers execution to a program line or label when the 
specified timer comes due and the statement that is currently being executed is completed. 







T simplified syntax 
OH TIMER # timer number , 





seconds UTU line number 
label 








The timer number is a numeric expression that must evaluate to a rounded value of 1, 2, or 3. This 
specifies which of the three timers to set. The number of seconds is also a numeric expression. It sets 
the number of seconds between the time and the timer is set and the time it will expire. Timers can be 
set to a precision of 1/32 second. The range for seconds is 1/32 through 134,217,727 seconds, a little 
over four years. If you specify a value smaller than 1/32 second, the computer sets the timer to 1/32 
second. If you specify a value greater than the maximum, the HP-71 uses the maximum value. 


Once set, timers remain active until the program ends or until they are deactivated (described below 
under “Deactivating a Timer”). Timers remain active if a program is suspended, but they don’t execute 
the specified branching until program execution resumes. 


Example: 


10 ON TIMER # 1, 10 GOTO 50 The interrupt transfers execution to line 50. 


20 GOTO 20 
50 DISP “TEN SECONDS” 


60 BEEP 100 


70 DISP “CONTINUE” Execution continues as it does after any other 
unconditional branch. 


When a timer set by OH} TIMER #... GOTO expires, the HP-71 automatically resets it using the 
specified interval. That is, a timer set to an interval of 30 seconds will expire every 30 seconds, causing 
a branch to occur. 
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Timer Branching With GOSUE (OH TIMER #... GOSUB) 


The OH TIMER #...GOSUE statement causes a branch to a subroutine when the specified timer 
expires. 


simplified syntax 


OH TIMER # timer number, seconds GOSLIE line number 
label 
With OH TIMER #...GOQS5U6, program execution branches to the specified subroutine when the 


timer expires. When the HP-71 encounters a FETLIF‘H statement, it resets the timer and branches 
back to the statement following the one that was being executed when the timer expired. 


Example: 

10 ON TIMER #2, 15 GOSUB 100 Sets a subroutine branch to line 100 at 15-second 
intervals. 

20 DISP “WAIT FOR TIMER” 

30 GOTO 20 

100 DISP “TIMER EXPIRED” Execution transfers to this line when the timer 
expires. 

110 RETURN Causes a branch back to the statement following 
the one that was being executed when the timer 
expired. 


More About Timers 


Timers Within Subprograms. Timers are global in that the three timers which can be set in a main 
program can also be set in a subprogram. However, the effects of timers are local in that they can cause 
a branch only to a line or label within the main program or subprogram in which they are set. Also, 
they can cause a branch only when the main program or subprogram in which they are set is currently 
running. 


If a timer is set and then a subprogram is called, the timer can’t cause a branch until the subprogram 
ends. Similarly, if a timer is set in a subprogram and the subprogram ends, the timer remains active, 
but won’t cause a branch until the subprogram is called again. 
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When the Computer is Off. If a program activates a timer and then executes EE or FF, the timer 
remains active. When it expires, the computer turns itself on and begins executing the program at the 
line or label specified in the OH TIMEF # statement. This technique is commonly used when the 
HP-71 is required to take a reading from an external device (such as a voltmeter) at specified intervals, 
but is not otherwise required to be on. Thus, it can set a timer, turn itself off, then repeatedly turn 
back on when the timer expires, take a reading, and turn itself off again. 


Example: The following program sets a timer, executes EEEF, and turns off the HP-71. Then, at 3 
second intervals, the HP-71 turns itself on, executes EEEF, then turns itself off. 


Lines 40 through 80 are executed each time the timer comes due. When the HP-71 has beeped 10 
times, the program deactivates the timer (described below under “Deactivating the Timer”). 


10 DESTROY | Ensures that I is available for use as a simple 
numeric variable. 

20 I=1 Sets the initial value of I. 

30 ON TIMER # 1,3 GOTO 40 Sets timer 1 to expire every 3 seconds. 

AO DISP | | Displays the value of I. 

50 BEEP | Beeps. 

60 I=I+1 Increments I. 

70 IF i>10 THEN OFF TIMER # 1 Deactivates the timer if it has beeped 10 times, as 
| indicated by the value of I. 

80 BYE Turns the HP-71 off. 


Deactivating a Timer (2FF TIMER #) 


A timer can be deactivated by executing OFF TIMER #. 


CFF TIMER # timer number 


For example, the statement (OFF TIMER #2 deactivates timer 3. 


All three timers are simultaneously deactivated when a program ends. (For more information about 
ending a program, refer to “Ending a Program,” page 155.) 
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Looping 


Repeatedly executing a sequence of statements is called looping. A simple loop begins with a FOF 
statement, which initializes the loop, and ends with a HET statement. Simple loops can be located 
within other loops to form nested loops. Nested loops are commonly used to process arrays and to 
manage data files. 


Simple Loops (FOF ... HET) 


The combination of the FOF and HE#T statements enclose a sequence of statements which are to be 
executed a specified number of times. 


FUR loop counter=initial value TO final value [STEF step size] 





HE*T loop counter 


The FOF statement defines the beginning of the loop and initializes a variable, called the /oop counter, 
that determines the number of times the loop is to be executed. The loop counter must be a simple 
numeric variable. The initial value, final value, and step size are numeric expressions. They define the 
initial and final value of the loop counter and the increment between successive values. If the step size 
isn’t specified (the STEF part of the statement is optional), the HP-71 sets it to 1. 


Examples: 


FOR I = 255-8 To 255 

HEMT I 

FOR J = ¢A AND BY To x*2 + &% STEP ¥ 
NEXT J 

FOR Li = 184 To 266 STEP 25 


HEXT Ld 
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The FitiF statement performs four operations: 
e It sets the /oop counter to the specified initial value. 
e It stores the final value for the loop counter. The final value determines when to stop looping. 
e It stores the step size. 
e It marks the start of the loop. 


The HET statement performs three operations: 
e It defines the end of the loop. 
e It increments the /oop counter according to the value of the step size. 


e It tests to see if the loop counter has been incremented beyond the final value. If so, the program 
exits the loop and executes the statement following the HE#T statement. If the final value has not 
been exceeded, the program branches to the first statement following the FCF statement. 


There are two rules governing the branching into and out of FOR ...HE#T loops: 


e Execution of a FOR... NEXT loop should always begin with the FF statement. Branching into 
the middle of a loop produces an error if the HE#T statement is executed before the program 
executes the corresponding FUIF statement. 


e It is permissible to branch out of a loop without completing it. After exiting a loop, the loop counter 
retains its value for possible use later in the program. 


Nested Loops | 


The HP-71 allows nesting of FUR ...HE#T loops. Nesting occurs when one or more loops are 
contained (nested) in another loop. Nested loops can’t overlap—each loop (except the first one) must 
be wholly contained in another loop. Nesting is limited only by the amount of available RAM. 


Example: The following program fragment, shown without line numbers, illustrates how nested loops 
can be useful in an application such as multiplying matrices. The matrix Fi is multiplied by E to obtain 
the result matrix ©. 

MPTIOW BASE i 

M=2@H=4aP=2 

QIN Ath, da,btcn,Pa,benm, Pa 

FOR JT=1 To ff 

FOF J=1 TO F 
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The HP-71 offers flexibility in how FOF... HET loops are used. However, when using nested loops, 
you should follow these guidelines: 


¢ Every FOF statement should have a matching HET statement—that is, after each FUF state- 
ment, there should be a HET statement which uses the same loop counter variable. 


° Nested loops can’t use the same /oop counter variable. 


¢ Loops should not overlap. 


The IF... THEH statement enables a program to execute one or more statements based on the value 
of a numeric expression. 


simplified syntax 





IF numeric expression THEH statements 


If the expression between IF and THEH evaluates to 0 (false), program execution skips to the next line. 
If the expression evaluates to a value other than 0, statements after THEH are executed. 


One or more statements can follow THEH providing they are concatenated with the @ symbol. How- 
ever, some statements aren’t valid in an IF ... THEH statement. The keyword dictionary in the refer- 
ence manual shows for each keyword whether it can be included in an IF... THEH statement. 


For example, another IF ... THEH statement is not allowed after THEN, though it is allowed after 
ELSE. 


Conditional Branching 

Often the IF ... THEH statement is used for conditional branching. Using GOTO or GOSUE in the 

statement causes program execution to branch depending on the outcome of a conditional test. 
simplified syntax 


IF expression THEH [GTO] line number 
IF expression THEH [GOTO] label 


simplified syntax 


[IF expression THEH GOSUE line number 
IF expression THEH GOSUE label 
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Notice that the keyword GOT isn’t required immediately after THEN. If a /ine number or labe/ appears 
immediately after THEH, the computer recognizes this as an implied G01T. For example, 


IF Fi=Q1 THEM 146 
causes program execution to branch to line 100 if P1 equals Q1. 


However, if you want conditional branching to a subroutine, you must use the Z051/E keyword. For 
example, the statement 


TF Fifth] THEM GOSUB HEWFORM 


causes program execution to conditionally branch to a subroutine beginning at the label HEHMF ORM. 


Optional ELSE 


ELSE is an optional keyword which can be used in the IF... THEH statement. It provides for execu- 
tion of statements when the expression between IF and THEH evaluates to 0. 


simplified syntax 





IF expression THEN statements EL=E statements 


When the expression between IF and THEH evaluates to a nonzero number (true), the statements 
between THEH and ELSE are executed. When the expression evaluates to 0 (false), only the statements 
after ELSE are executed, then execution continues to the next line. 


Examples: 
IF I=8 THEM Hee+y¥ @ 221 ELSE H=H-'Y @& Z=e 
IF FLAGCOVRS THEN WMt='Overflow' ELSE M#='Ho Error! 


In the same manner as described above, GOSUE and GOTO can be used after ELSE to provide con- 
ditional branching. 
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Examples: 


GOSUE ‘REFORMAT: 


IF #34 THEH ia 


IF T#=A# THEN 245 ELSE FRM] 


art eat wat BL 


If L is not equal to zero, then execution 
branches to EXIT (an implied GOTO). If L 
equals zero, then execution branches to 
REFORMAT. 


If > is true, execution branches to line 100 
(implied). 


If T =A is true, execution branches to line 245 
(implied) otherwise it branches to FRM 1 
(implied). 


If HOT ‘' is true, the value of T is assigned to 
and execution branches to the subroutine begin- 
ning at line 50, otherwise execution branches to 
line 150 (implied). 
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Overview 


The HP-71 has 128 flags, all of which can be tested and 96 of which you can set and clear. This section 
covers: 


e Types of flags. 
e Testing flags. 
e Setting flags. 
e Clearing flags. 
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Introduction to Flags 


The previous section describes conditional-execution statements, which are statements that direct pro- 
gram flow based on the outcome of conditional tests. A type of conditional test that can be used in 
programming is the flag test. A flag is a status indicator that is either set (meaning true) or clear 
(meaning false). A flag test is a function that indicates the state of a specified flag, either set or clear. 


Flags numbered —64 through —1 are system flags. System flags are used by the computer operating 
system to indicate the status of the computer. System flags that are useful from the keyboard and in 
BASIC programs are described below under “System Flags.” 


Flags numbered 0 through 63 are user flags. These flags have no special meaning to the computer. Their 
meanings can be arbitrarily defined within a program. You can use them in a program to indicate a 
condition that isn’t represented by the system flags. (An example of programming with user flags is 
given below under “User Flags.”) 


All flags can be tested with the FLAG function. 


FLAG flag number > 





This function returns a value of 1 if the specified flag is set and 0 if the flag is clear. 


You can test any flag with this function. The fag number can be in the range —64 through 63. If you 
specify a non-integer, it will be rounded to an integer before the flag is tested. You can use the math 
exception flag mnemonics, such as I'L and [\Z, in place of flag number to test flags —4 through —8. 


Examples: 

FLAGS Tests flag 5. 

FLAGCIVL 3 Tests the invalid flag. 

FLAGCH3 Tests the flag indicated by %. 

IF FLAG*-155 THEH 1448 Branches to line 100 if flag —15 is set. 
H=FLAGCL23#5 Sets A=5 if flag 12 is set and A=0 if flag 12 is 


clear. 
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Setting and Clearing Flags 
Flags can be set and cleared by SFLAG, CFLAG, and FLAG. 
Setting Flags (2F LHC) 


With =FLAG you can specify that all user flags be set, that all the math exception flags be set, or that 
selected individual flags be set. System flags —32 through 63 can be set with SFLAG. 


SFLAG flag number, flag number... 





SFLAG ALCL 

SFLAG WATH 
Examples: 
SFLAG 4,5,25,0VF Sets flags 4, 5, 25, and the CF flag. 
SFLAG I,J,K Sets the flags indicated by I, ./, and EF. 
SFLAG ALL Sets flags 0 through 63. 
SFLAG MATH Sets the five math exception flags. 


You can also set a flag at the time you test it using FLAG. 


FLAG ¢flag number, new value: 





When using FLAG to set a flag, flag number must be in the range —32 through 63. The new value can 
be any number, including Inf and NaN. If new value is 0, the flag is cleared; if it is not 0, the flag is set. 
You can set only one flag at a time with this function. 


Example: 
PLAGG Ss 1 Tests flag 5 then sets it to 1. 


Clearing Flags (CFLAG, FE=ET) 


You can clear flags with CFLAG or FLAG. 


(FLAG flag number, flag number... 


LPLAG ALL 
CFLAG MATH 
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The same parameter restrictions apply to CFLAG as apply to FLAG. 


Examples: 
CFLAG 3,5, UNF Clears flags 3, 5, and the underflow flag. 
CFLAG L,IT#d Clears the flags indicated by the numeric 


expressions. 


You can clear flags with FLAG in the same way that you set them. 


Example: 

FLAGS, G2 Tests flag 5 and clears it. 

FLAGS, 3 Tests flag 5 then sets it if J#0 and clears it if 
J=0. 

FLAGS, PLAGES3-15, Tests flag 5 and switches its state (from clear to 


set or set to clear). 


Flags —32 through 63 can be collectively cleared by executing FESET or performing a memory reset 
(IHIT: 3). 


User Flags 


User flags are those numbered 0 through 63. These flags can all be set, tested, and cleared by the user. 
These flags are not used by the computer and have no meanings except those attributed to them by the 
user. 


Flags 0 through 4 have annunciators in the display. When any of these flags are set, the corresponding 
annunciator (0, 1, 2, 3, 4) comes on. 


Example: When measuring distances on a map, you might be measuring in inches (the English sys- 
tem) or in centimeters (the metric system). Distances measured on a map must be converted to actual 
distances on the ground to be meaningful. You might want to know actual distances on the ground in 
terms of miles or kilometers. Using flags you can write a program that accepts map measurements in 
inches or centimeters and converts them according to the map’s stated scale into actual distances, in 
either miles or kilometers. One flag can indicate the units you are measuring in and another flag can 
indicate the units in which actual distances are represented. 
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Suppose you are planning a hike in the Cascade Range in Oregon and you want to know the straight- 
line distance between Mt. Jefferson and Grizzly Peak. You have a topographic map which has a scale 
(representative fraction) of 1:62500. (That is, one inch on the map represents 62,500 inches on the 
ground.) The distance on the map between the peaks is 8.8 centimeters. How many miles separate the 
two peaks? 


The formulas for converting inches and centimeters to miles and kilometers are: 


miles = s X (inches / 63360) 

miles = s X (centimeters / 160934.4) 
kilometers = s X (inches) x (.0000254) 
kilometers = $s X (centimeters) x (.00001) 


where s is the denominator of the representative fraction. (In this example, s is 62500.) 


The following program allows you to select the type of input, inches or centimeters, and the type of 
result, miles or kilometers. The program uses flags 1 and 2 to indicate to the program which units are 
being used. 


In the program, flag 1 indicates which units you are using to measure distances on the map. Flag 1 set 
indicates inches and flag 1 clear indicates centimeters. Flag 2 indicates the units used to express the 
actual distances. Flag 2 set indicates miles and flag 2 clear indicates kilometers. 


Flag 1 is set or cleared in line 60 and flag 2 is set or cleared in line 90. There are four possible combina- 
tions of flags 1 and 2 being set and clear. The state of each flag is tested in lines 120 through 150 to 
indicate to the computer which conversion formula to use. For example, if you are measuring in centi- 
meters and displaying results in miles, flag 1 will be clear and flag 2 will be set. The conversion formula 
in line 130 is then used and the result displayed. 


10 ‘SETUP’: DELAY 1,1 @ FIX 2 


20 DESTROY S,M$,R$,M,R Initializes the variables to be used in the program. 

30 INPUT “MAP SCALE?’; S Inputs map scale. 

40 DISP “MEASUREMENTS” 

50 INPUT “ in OR cm (1/C)?”; M$ Inputs type of measurements. 

60 IF UPRCS$(M$)=“I’ THEN SFLAG 1 ELSE Sets flag 1 to indicate inches or clears flag 1 to 
IF UPRC$(M$)=“C” THEN CFLAG 1 indicate centimeters. 
ELSE 40 

70 DISP “RESULTS” 

80 INPUT “ mi OR km (M/K)?”; R$ Inputs type of results. 

90 IF UPRC$(R$)=“M” THEN SFLAG 2 Sets flag 2 if results are in miles and clears flag 2 
ELSE IF UPRC$(R$) = “K” THEN if results are in kilometers. 


CFLAG 2 ELSE 70 
100 ‘CONVERT’: DELAY 4 





110 INPUT “MEASUREMENT? ”; M @ IF 
M<=0 THEN 170 


120 IF FLAG(1) AND FLAG(2) 
THEN R=S*M/63360 @ DISP R; “ mi’ 


130 IF NOT FLAG(1) AND FLAG(2) 
THEN R=S*M/160934.4 @ 
DISP R; “ mi” 


140 IF FLAG(1) AND NOT FLAG(2) 
THEN R=S*M*.0000254 @ 
DISP R; “ km” 


150 IF NOT FLAG(1) AND NOT FLAG(2) 
THEN R=S%*M*.00001 @ DISP R; “ km’ 


160 GOTO ‘CONVERT’ 


170 END 
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Inputs a measurement and branches to the end 
of the program if the measurement is less than or 
equal to zero. 


Converts inches to miles if flags 1 and 2 are set. 


Converts centimeters to miles if flag 1 is clear 
and flag 2 is set. 


Converts inches to miles if flag 1 is set and flag 
2 1s Clear. 


Converts centimeters to kilometers if flags 1 and 
2 are both clear. 


Directs program execution to the label COHWERT 
(in line 100). 


Now run the program to find the distance between the two peaks. 


Input/Result 
RUN 





MEASURENEHTS 


im OF cm 





L; [END LINE 


RESULTS 


mi QFE kim 





Prompts you to enter the denominator of the re- 
presentative fraction. 


You key in the scale. 


Prompts you to indicate the units you’ll use to 
measure distances on the map. 


Key in © for centimeters. 


Prompts you to indicate the units you want re- 
sults displayed in. 
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M Key in M for miles. 


MEA SUREMEM TY Prompts you for a measurement. 





a8 Key in the distance on the map (in centimeters) 
from Mt. Jefferson to Grizzly Peak. 


Displays the actual distance in miles. 





MEASURERMEHT ? Prompts for another measurement. 





ia Ends the program. 


The program continues to prompt for measurements until you enter a measurement of 0. If you want to 
use different units of measurement, simply run the program again. 


System Flags 


The HP-71 flags are divided into two groups—system flags, whose meanings are predefined by the 
HP-71, and user flags, whose meanings can be defined by the user. 


All flags are global—they can all be used by subprograms (even those in other files) and user-defined 
functions. No flags are local to program files or subprograms. 


System flags indicate the state of the HP-71. Flags —32 through —1 can be set, cleared, and tested by 
the user. Flags —64 through —33 can only be tested. 


The flags that you can use are described here. Flags not described are used by the HP-71 for its 
operation. 


Warning Message Flag (—1) 


By setting the warning message flag you can suppress the display of most warning messages. System 
messages, error messages, and certain warning messages can’t be suppressed. (For a list of which warn- 
ing messages can be suppressed, refer to “Errors, Warnings, and System Messages,” in the HP-71 Ref- 
erence Manual.) 
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Beeper Flags (—2, —25) 


When flag —2 is set, the beeper will not sound when FEEF is executed. When flag —2 is clear, the 
beeper operates normally. 


The beeper has two volumes which can be selected by setting or clearing flag —25. When this flag is 
set, the beeper volume is loud. When the flag is clear, the volume is soft. 
Continuous-On Flag (—3) 


To save battery power the HP-71 automatically shuts itself off after 10 minutes of inactivity. There are 
times when you might want to leave the HP-71 on continuously. You can set the HP-71 to continuous 
on by setting flag —3. Clearing flag —3 restores the automatic shut-off feature. 


Math Exception Flags (—4 through —8) 


One or more of these flags are set whenever a math exception occurs. (For more information about 
math exceptions, refer to “Math Exceptions,” page 57.) 


Once set, the math exception flags can be cleared individually by using CF LAG, or cleared collectively 
by executing CFLAG MATH. 


User Keyboard Flag (—9) 


When set, flag —9 indicates that the User keyboard is active. Setting the flag activates the User key- 
board. (This is equivalent to executing LISER OH.) Clearing the flag deactivates the User keyboard 
(equivalent to executing USER OFF). This flag can be useful in a program when you are using a KEY 
file and want to ensure that the User keyboard is active. 


Angular Setting Flag (— 10) 


This flag, when set, indicates that the arguments and results of trigonometric functions are expressed 
in radians. When clear, it indicates that arguments and results are expressed in degrees. 


Example: The following routine computes the arcsine of an input value and displays the result in 
degrees or radians, depending on the status of flag —10. 


10 INPUT X 
20 IF FLAG(-10) THEN DISP ASIN(X);“ RADIANS” Include a space after the two leading quotation 
ELSE DISP ASIN(X);“ DEGREES’ : marks. 


When flag —10 is set, the RAD annunciator comes on in the display. Radians and degrees can also be 
set on the HP-71 using the FAD IANS or DEGREES statements. 
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Round-Off Setting Flags (—11, —12) 


Flags —11 and —12 indicate the current round-off setting, according to the following table: 


Example: 


10A = 
20 IFA 
30 IFA 
40 IFA 
50 IFA 


Round-Off Setting Flags 


Near 
Zero 
Positive 
Negative 















The following routine displays the current round-off setting. 


FLAG(—12) + 2 * FLAG(—11) 


| 


0 THEN R$ = 
1 THEN R$ = 
2 THEN R$ = 
3 THEN R$ = 


“NEAR” 
“ZERO” 
“POSITIVE” 
“NEGATIVE” 


60 DISP “ROUND-OFF: ”; R$ 


You can select the round-off setting by setting or clearing the appropriate flags or by using the 
ROLHEO statement. 


DFT IO 


Display Format Flags (—13, — 14) 


Flags —13 and —14 indicate the current display format according to the following table: 


Display Format Flags 


Display Format 





These flags are useful for numeric routines that need to know how numbers are displayed. 
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Example: The following routine displays the current display format. 


10 A = FLAG(—13) + 2 * FLAG(—14) 


20 IF A = 0 THEN R$ = “STD” 
30 IF A = 1 THEN R$ = “FIX” 
40 IF A = 2 THEN R$ = “SCI” 


50 IF A = 3 THEN R$ = “ENG’ 
60 DISP “FORMAT:”: R$ 


The display format can also be set using STO, FI, 3 CI, and EHS. 


Lowercase Flag (—15) 


Flag —15, when set, indicates that the keyboard is set to lowercase. That is, pressing letter keys dis- 
plays the lowercase characters. When clear, the keyboard is set to uppercase. 


Pressing the [9] key before a letter key displays the opposite case of that letter. For example, when flag 
~—15 is clear, pressing (9)[D] displays 4. But when flag —15 is set, pressing (9](D]} displays (. 


This flag is useful in a program when you want to ensure that the keyboard is set to one case. The 
keyboard can be set to lowercase or uppercase using LC OH and LC CFF. 
Base Option Flag (— 16) 


When set, flag — 16 indicates that the current base option for dimensioning arrays is 1. When clear, the 
flag indicates that the base option is zero. The base option can also be set using the OF TIOCH BASE 
statement. 


Number of Digits Flags (—17 through —20) 


Flags —17 through —20 indicate the number of significant digits currently displayed if the display 
format is FI#, SC1, or ENG. The following table indicates what the combinations of these four flags 
indicate: 
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Number of Digits Displayed 


Number of Digits | Flag —17 | Flag —18 | Flag —19 | Flag —20 


0 
1 
2 
3 
4 
5 
6 
v 
8 
9 
0 
1 


at, ok 





These flags are useful when a program needs to determine the number of significant digits currently 
displayed. (You can display up to 11 digits to the right of the radix mark.) 


Example: The following statement shows the current number of significant digits displayed. 
FLAG -17>9+2#FLAGC-189 +4#FLAGC-154+8eFLAG¢-285 


The number of digits displayed can be set using FI, SCI, or EHC. 


BASIC Prompt Flag (— 26) 


When flag — 26 is set, the HP-71 suppresses the display of the BASIC prompt. The flag is cleared when 
you press [END LINE]. 


ESACT Flag (—46) 


When set, flag —46 indicates that EXACT has been executed. This flag is cleared when the clock is 
reset or a memory reset occurs. You can only test this flag. 
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Annunciator Flags (—57, —60 through —64) 


The annunciator flags each indicate the status of a display annunciator. When set, a flag indicates that 
its corresponding annunciator is on. Flags and their corresponding annunciators are shown in the fol- 
lowing table. 


Annunciator Flags 


omni | Fa 


AC 
Alarm ((e)) 
BAT 
PRGM 
SUSP 
CALC 
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Subprograms and User-Defined Functions 


Contents 
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Overview 


The complexity of a program can often be reduced by using loops and subroutines that perform certain 
tasks repeatedly. However, a program must often branch around subroutines and loops when they 
shouldn’t be executed. Also, routines that operate on different sets of variables often use their own sets 
of variables to contain intermediate values. For a large program, operations on numerous variables can 
become difficult to trace and control. 


Subprograms and user-defined functions, which can be used repeatedly, overcome some of the disadvan- 
tages of subroutines and loops. These are independent programming structures that are executed only 
when explicitly referenced. Unlike a subroutine or a loop, you don’t need to branch around a 
subprogram or a user-defined function when you don’t want it executed. 


Subprograms and user-defined functions can contain their own sets of variables. When you write a 
subprogram, you don’t need to remember which variable names are used by another program or 
subprogram. A variable name in a subprogram can be the same as one in a program or another 
subprogram, yet the computer regards the duplicates as separate variables. 
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Subprograms and user-defined functions are structured so that you can readily trace how values are 
input and output by them. They offer the following advantages: 


¢ They have names by which they are referenced. 

e They enable you to reduce large programs to a series of smaller, simpler, independent units. 

¢ They are executed only by a specific reference to them. 

e The names of variables within a subprogram or a user-defined function can be duplicates of vari- 

able names in a program or another subprogram. 

This section describes how to incorporate subprograms and user-defined functions into your programs. 
More specifically, this section covers: 

e How to write, store, and use a subprogram. 

¢ How to write and execute a user-defined function. 

¢ How to use recursion. 


¢ How the HP-71 maintains different “environments” for subprograms and user-defined functions. 


Subprograms 


To simplify a sizable program, a programmer often reduces it to a collection of routines, each of which 
performs one of the tasks of the program. Rather than creating a single, large program, the program- 
mer reduces the amount of work by creating a series of smaller, simpler program units. Traditionally, 
the program units available on a BASIC computer have been subroutines and user-defined functions. 
The HP-71 offers a third type of program unit—the subprogram. 


A subprogram is a distinct group of program lines that can reside in a BASIC file separately from the 
main program. Subprograms can be called by a main program (or another subprogram) in a manner 
similar to executing a subroutine. Subprograms reside in a program file following the main program, as 


shown in the following illustration: 


Subprogram 
Subprogram 
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Form of a Subprogram (2UE, ENO SUE) 


Subprograms are independent parts of a program that are essentially small but complete programs. 
Subprograms are delimited by a header statement, which contains the subprogram name, and a termi- 
nating statement. A subprogram is executed when it is called using the CALL statement (described 
below). 


Form of a Subprogram 


Starts with the LIE keyword 


Name Formal parameters 
[OD GO a, 


Header statement —— SUB IHTEGRALCH, Eta, CFs 
; Program lines 


Terminating statement ——" EHO SUB 


The 3LIE Statement. The SUE statement is the first statement of a subprogram. It identifies the 
subprogram and declares its parameters. 


simplified syntax 





SUE subprogram name [« formal parameter list >} 


As with file names, a subprogram name can contain up to eight letters or digits, the first of which must 
be a letter. The name is followed by an optional formal parameter list, which is a list of variable and 
array names, called parameters, that will contain information passed to the subprogram by a calling 
program. 


The Formal Parameter List. A subprogram obtains values from a calling program through the for- 
mal parameter list. Values can also be passed back to the calling program through this list. The formal 
parameter list is enclosed in parentheses, and parameters are separated by commas. 


Example: 


SUE SOLWECA,B,C13 The subprogram’s name is 3UiL‘\!E and its formal 
parameters are A, EB, and C1. 


Ending a Subprogram. A subprogram ends with an EHD SUE statement. 


FHOD SUE 
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The function of EHD SUE is similar to RETURH in that it returns execution back to the calling 
program. It also clears the memory used to execute the subprogram, making it available for other uses. 
(Refer to “Subprogram Environments” below.) 


As an alternative to using EHD SUB, you can use EHD. Actually, you aren’t required to use EHD SUE 
or EHD to end a subprogram. A subprogram will end when the computer encounters the next SLE 
statement or the end of the file. 


Storing a Subprogram. Subprograms can be in a program file either with a main program or by 
themselves. A file can contain more than one subprogram; however, all subprograms must be listed 
after the main program (if one exists) and should have no program lines between them. (Any program 
lines between subprograms will never be executed.) 


Main Program 


EHO 
SUB 


EHO SUB ~«— The EHD SUE statement clearly marks the 
end of the subprogram. 





«— The end of the file (or another 3\IE statement) 
can also mark the end of a subprogram. 


Calling a Subprogram (TALL) 
The CALL Statement. The CALL statement executes a subprogram. 


simplified syntax 





CALL subprogram name [* actual parameter list] [IH program file] 


This statement’s elements correspond to the 3UE statement. The subprogram name is the name of the 
subprogram to be executed. The actua/ parameter list is a set of expressions and variables that are 
passed to a subprogram. The program file indicates the file in which the called subprogram is located. 


CALL is like GOSUE in that it transfers program execution to a subprogram until the subprogram is 
finished, then execution returns to the statement following TALL. 
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Actual Parameters. Many different (HLL statements can invoke the same subprogram so long as 
their actual parameter lists match the =LIEB statement’s formal parameter list item for item, type for 


type. 


The following illustration show the correspondence between a CALL and a SUE statement. 


CALL SUBPROGI¢ 


A,25,0#3 The CALL statement invokes the 
subprogram and passes information to it. 
Corresponding 
Types 
= LIE SUBPEOGLT CS, T, Vea 
EHO SUB Returns execution to the statement after TALL. 


In this illustration, the formal parameters = and T are numeric variables and '.!# is a string variable. 
Any ALL statement that calls SUBFEOG1 must have numeric values or expressions as its first two 
parameters and a string value or expression as its last parameter. 


Types of Actual Parameters. In some applications, a program needs information passed back to it 
from a subprogram. This can be accomplished by passing a variable as a parameter to a subprogram 
which, in turn, alters the value of that variable. 


A CALL statement can pass three forms of parameters to a subprogram: 


e Value parameters, which can’t be changed by a subprogram. In the actual parameter list, these are 
variables that are individually enclosed in parentheses, and numeric or string expressions. 


e Reference parameters, which can be changed by a subprogram so that values can be passed back to 
the calling program or subprogram. In the actual parameter list, these are variable names which 
aren’t enclosed in parentheses. Reference parameters can be variables only. Also, arrays can be 
reference parameters only. 


e Channel numbers, which are numbers associated with data files. A special type of value parameter, 
they are preceded by a # in a formal parameter list. (The use of data files is described in section 
14, “Storing and Retrieving Data.”) 
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Example: A program calls a subprogram that computes the octal equivalent of a decimal number. The 
program passes value parameter T, which contains the decimal number, and a reference parameter E #, 
which is assigned an octal equivalent by the subprogram. 


IHFUT T T contains the decimal number; it is a value 
parameter. 

CALL OCTALE& Ts, EF2 E+ is the reference parameter; it contains the 
octal representation when the subprogram is com- 
pleted. 

SUB OCTALCA, EB: A contains the value passed in T. 


Changes to E# result in equal changes to E#. 


E+ = octal equivalent The subprogram assigns the octal representation 
to E#. Since E# is the corresponding reference 
parameter, it is also assigned the octal representa- 


tion. 
EMO Sue 


When CALL is executed, the values of the value parameters are assigned to the corresponding formal 
parameters in the SUE statement. Reference parameters become linked with their corresponding for- 
mal parameters in such a way that changes to the formal parameters result in equivalent changes to 
the reference parameters. In this way values are passed back to the calling program or subprogram. 
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All variables declared within a subprogram are local to that subprogram. That is, they are not shared by 
the calling program. This means that a variable used in a subprogram can have the same name as one 
in the calling program, yet the HP-71 treats them as different variables. Also, a reference parameter 
need not have the same variable name as its corresponding formal parameter. The subprogram operates 
within its own local environment. (Local environments are described below under “Subprogram 
Environments.” ) 


Parameters can be any type of variable—they can be simple numeric, array, string, or string array 
variables. Value parameters can be numeric or string expressions, but the expressions can’t contain any 
references to user-defined functions. Reference parameters must be variables. 


Channel numbers, which are associated with data files, can also be passed as actual parameters to a 
subprogram. A channel number in a subprogram’s formal parameter list becomes associated with the 
same file as the corresponding actual parameter. 


If a subprogram opens a data file using a channel number that is not in the formal parameter list, that 
channel number is local to the subprogram, and its data file will be closed when the subprogram ends. 
If a subprogram doesn’t have a formal parameter list, any channel number it uses is global. The chan- 
nel number’s corresponding data file remains open after the subprogram ends. (For more information 
about channel numbers, refer to “Data Files,” page 247.) 


Examples: 

CALL SOLVECSEAt+E +5e-12,A13 The first parameter is a value parameter. The sec- 
ond, Fil, is a reference parameter. 

CALL EDITORCOISP#,LE&7#, ¢K22 All parameters are value parameters. 


An Example Subprogram. Now that some of the elements of a subprogram have been described, 
let’s look at a complete subprogram to see how it works. 


Example: The Fibonacci series is a mathematical series in which each term is the sum of the two 
preceding terms. The values of the first and second terms in the series are defined as 1. The third term 
is the sum of these two, 2. The fourth term is the sum of the second and third, 1 + 2 = 3, and so on. 


The following program, F I BGHAC, uses a subprogram to compute the nth term of the Fibonacci series 
for 0<n<61. It prompts you to enter a value from the keyboard, calls a subprogram to determine the 
corresponding Fibonacci number, and displays the result. The values returned are exact (no round-off 
errors). 


To key in this example program, type EDIT FIBONMALC and enter the following program 
lines. 
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10 DESTROY N, A @ STD 
20 INPUT “TERM? ”:N 

30 CALL FIBO (N,A) 

40 DISP “TERM ”:N:“ IS ":A 
50 SUB FIBO(B,C) 


60 IF FP(B) OR B<?1 OR B>?60 THEN C=0 
-@ GOTO 160 


70 IF B=1 OR B=2 THEN C=1 @ GOTO 160 


80 X=1 

90 Y=1 

100 FOR I=3 TO B 
110 Z=X 

120 X=X+Y 


130 Y=Z 

140 NEXT | 
150 C=X 
160 END SUB 


209 


E corresponds to H, and © corresponds to Fi in 
line 30 above. 


Checks for an input error. 


Assigns 1 to © for the simple cases. Since Fi is a 
reference parameter, it is assigned the value of (. 


’ and ® are two consecutive terms. 
Finds the value of the Eth (Hth) term. 


*, assumes the value of the next term and ‘i’ 
assumes the value of %. 


= 1s a temporary variable to store %. 


* contains the value of the Eth term. 


F TE is the name of the subprogram. The number input from the keyboard, which must be an integer 
greater than 0 (the program returns 0 for an improper input), is assigned to H, which is then passed as 
a reference parameter to the subprogram. The subprogram assigns the Hth term of the series to the 


reference parameter, Al. 


To use the program, press and at the prompt enter an integer, n, then press [ENDLINE]. The 
program will compute and display the value of the nth term in the Fibonacci series. 


Input/Result 
RUN 


TERM? 


Executes FIEGHAC (assuming it’s the current 
file). 


Prompts you for the number of a term in the 
series. 
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& Selects the 6th term. 


Displays the value of the 6th term. 





Calling a Subprogram In Another File. You can call a subprogram in another file by specifying the 
file in the CALL statement. 


Examples: © 

CALL FIBOi¢6s>, Ta IH Calls FIBO1 in the file MATHSET in port 2. 
MATHSET:PORTC 22 

CALL OATEL IH OATES Calls CATE1 in the file DATES. 


The HP-71 can locate a subprogram in another file even if you don’t specify the file. Therefore, it isn’t 
necessary to include a reference to the subprogram’s file in the CALL statement unless another 
subprogram of the same name resides in memory. 


You can also call a program as a subprogram, but you can’t pass it any parameters. 


simplified syntax 
CALL [file name] 


When calling a program, the HP-71 first searches the files in memory for a subprogram by the speci- 
fied name. If a subprogram isn’t found, then the HP-71 searches for a program file by that name and 
executes it as a subprogram. 


Examples: 
CALL Calls the current file as a subprogram. 
CALL AIRSPFEEO Calls HIF SFEEQ. The computer first searches 


for a subprogram by this name. If it doesn’t find 
one, it searches for a program and executes it. 


Subprogram Environments 


When you perform operations from the keyboard, you have access to variables, flags, files, the Com- 
mand Stack, and other HP-71 operating features. A program also has access to these features. Some of 
these features are available to all programs and subprograms. Other features are available only to the 
program or subprogram in which they are defined. These features collectively form an environment for 
a program or subprogram. 
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Those features that are always accessible to any program or subprogram comprise the global environ- 
ment. Those features that are defined or declared within a program or subprogram comprise the local 
environment for that program or subprogram. From the keyboard, you have access to the global envi- 
ronment and, at any time, one local environment. 


When you execute F'LIH, the program uses the same local environment as that used by the keyboard. 
This environment is the main environment. It can be considered the default local environment for the 
computer. 


The following illustration shows the relationship between the main environment and the global envi- 
ronment. A running program has access to the elements listed under Main Environment plus the 
elements listed under Global Environment. 


Main and Global Environments 


Global Environment Main Environment 


file names variables 
Command Stack arrays 
flags user-defined functions 


trap values channel numbers 
timers statement labels 
system settings” subroutines 

FOR... HEAT loops 





Saved Environments. When a subprogram is called (either by a program or from the keyboard), the 
main environment is saved and a new local environment is created for the subprogram. The 
subprogram has access to the elements of its local environment plus the elements of the global environ- 
ment. It doesn’t have access to the saved environment. The new local environment exists as long as its 
corresponding subprogram is in effect. When the subprogram ends, the local environment is erased and 
the main environment is restored. 


When a local environment is active, it is the active environment. If a subprogram becomes suspended, 
only the features of its local environment plus the global environment can be accessed from the 
keyboard. 


* System settings include the statistics array assignment (STAT), the OPTION, DEGREES, RADIANS, LOCK, STARTUP, 
USER, LC, and TRACE statements, and assignments affecting display or printer output (such as FIX, OELRY, and PWIOTH). 
Output device assignments such as DISPLAY 15 are also included. 
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Program and Subprogram Environments 


Global Environment Main Environment 
(saved) 


file names variables 
Command Stack arrays 
flags user-defined functions 
trap values channel numbers 
timers statement labels 
system settings subroutines 

FOR ...HEsT loops 


Subprogram 
Environment 
(active) 


variables 

arrays 

user-defined functions 
channel numbers 
statement labels 
subroutines 

FOR... HEAT loops 





Elements that are within a local environment can’t be accessed by another environment. For example, a 
user-defined function that is in a subprogram can’t be used by a main program or another subprogram. 
But features that are part of the global environment can be accessed by any environment. 


A program can call a subprogram, a subprogram can call another subprogram, and that subprogram can 
call even another subprogram. There is no predefined limit to the number of levels of subprogram calls 
that can occur. But each call results in an environment being saved and another one being created, 
using up more of main RAM. Thus, the amount of main RAM limits the number of levels of 
subprogram calls. 


Restoring Environments. When a subprogram ends, execution returns to the calling subprogram or 
program. Also, the subprogram’s environment is erased and the calling environment, the environment 
of the calling program or subprogram, is restored. 


For example, a program, FF0G1, calls a subprogram, SUBPROG1. The local environment for FEOG i 
(the main environment) is saved and the computer creates a new environment for SUBFRFOG1. This 
subprogram calls another subprogram, SUBFROG2. The environment for SUBFFEGG1 is saved and 
one is created for SUBFROGZ. 
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Program and Subprogram Environments 














Global Environment Main Environment 


















(saved) 
file names variables 
Command Stack arrays 
flags user-defined functions 
trap values channel numbers 
timers statement labels 


subroutines 
FOR ...HE#T loops 


system settings 











SUBPROG 1 
Environment 
(saved) 


variables 
arrays 
user-defined functions 
channel numbers 
statement labels 
subroutines 

FUR ...HEXT loops 



















SUBPROG2 
Environment 
(active) 







variables 
arrays 
user-defined functions 
channel numbers 
statement labels 
subroutines 

FOR ...HE#T loops 












While SUBFROG= is running, its environment is the active environment. Its calling environment is 
that of SUBPROGi, and the calling environment of SUBFROG1 is the main environment. Whenever 
program execution is suspended, the environment that is active at that time is the one that can be 
accessed from the keyboard. To access a saved environment, you must end one or more subprograms 
until the environment you want becomes the active environment. You can do this from the keyboard 
using EHD. 
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Ending a Subprogram Environment. When EHO or EHD SLE is executed within a subprogram, 
the subprogram ends and execution returns to the calling program or subprogram. The calling environ- 
ment is restored as the active environment. 


More specifically, when either EHO or EHO SUE is executed from within a subprogram, the HP-71 
does the following: 

e Returns execution to the calling program or subprogram. 

e Closes all files associated with local channels. 

e Clears memory associated with the subprogram’s local environment. 

e Clears any (1 ERROR condition set in the subprogram. 

e Restores any (1H ERROR condition set in the calling environment. 

e Restores the DATH pointer. 
Alternatively, you can end a program and clear the active and all saved environments using EHC) ALL. 


This statement ends program execution, but does not affect the variables declared within the main 
environment. 


If you execute EHO or EHO SLIB from the keyboard while a program is suspended during a 
subprogram, the statement follies the CALL statement that invoked the subprogram becomes the 
suspend statement. 


Recursive Subprograms 


What Is Recursion? A subprogram can call other subprograms the same way a main program can call 
a subprogram. A subprogram can also call itself as a subprogram. A subprogram that calls itself is a 
recursive subprogram. Each time a recursive subprogram calls itself, the HP-71 creates a new local 
environment, as it does for any other subprogram (as illustrated below). 
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Program and Subprogram Environments 









Global Environment Main Environment 

























(saved) 
file names variables 
Command Stack arrays 
flags user-defined functions 
trap values channel numbers 
timers statement labels 


subroutines 
FUR... HET loops 


system settings 











SLUEBR RCH 1 
Environment 
(saved) 







variables 
arrays 
user-defined functions 
channel numbers 
statement labels 
subroutines 

FOR ...HEXT loops 

















SUBFPROG1 
Environment 
(active) 








variables 
arrays 
user-defined functions 
channel numbers 
statement labels 
subroutines 

FOR... HET loops 










Recursive subprogram calls are useful in sorting and searching operations. Typically, recursive 
subprograms are used for more advanced programming applications; however, some smaller programs 
can be simplified if recursion is used. For example, instead of using the iterative algorithm in the 
Fibonacci program above, you could simply define the value of the nth term of the Fibonacci series as 
the value of the (n — 1)th plus the value of the (n — 2)th terms. The subprogram could then passn — 1 
and n — 2 as parameters to itself to determine their values. 
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Example: The following Fibonacci program, which is a revision of the previous one, uses a recursive 
subprogram. Key in this program and run it as you would the previous program. (Type 


FOIT FIBONAC2 (ENDLINE].) 


10 DESTROY N,A 

20 INPUT “TERM? ”;N 

30 CALL FIBO(N,A) 

40 DISP “TERM ”;N;“ IS ’;A 

50 SUB FIBO(B,C) 

60 iF FP(B) OR B<?1 OR B>?60 THEN C=0 Returns 0 if an input error is detected. 


@ GOTO 110 

70 iF B=1 OR B=2 THEN C=1 @GOTO110 ‘Returns 1 for the simple cases. 

80 CALL FIBO(B-1,S) Finds the value of (E — 1)th term and assigns it 
to 5. 

90 CALL FIBO(B—2,T) Finds the value of (E — 2)th term and assigns it 
to T. 

100 C=S+T Assigns the value of the Eth term, = + T, tol. 

110 END SUB 


The difference between this algorithm and the iterative algorithm in the previous example is that the 
iterative approach started with the value for the simplest term and worked up to the nth term while the 
recursive algorithm starts with the nth term and works its way to the simple term. 


Example: Execute the recursive Fibonacci program. 


Input/Result 

RUM FIBOMACS Executes the recursive Fibonacci program. 
TERM? @ Prompts for an integer. 

5 Finds the value of the fifth term. 


Displays the fifth term. 





Using the recursive algorithm, the subprogram determines the value of a given term by successively 
calling itself for each preceding term. To avoid calling itself endlessly, the subprogram returns a dis- 
crete value for the first and second terms. For any other term the subprogram calls itself until it 
returns the value of the second or first term. The different levels of subprogram calls end after comput- 
ing the values for their respective terms. 
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The subprogram found the value of a term by recursively finding the value of the two preceding terms, 
as shown by the following illustration:. 


CALL FIBO ¢5S,A3 
CHLL FIBU ¢€4,A3 + CALL FIBO ¢3,A2 
CALL FIEO ¢3,A5 + CALL FIBO ©2,A> CALL FIBO ¢2,A> + CALL FIBO ¢i,A; 


a. 


CALL. FIBO (2,A2 + CALL PIBO <1,A> 


The illustration shows the different levels of subprogram calls necessary to determine the value of the 
fifth term in the Fibonacci sequence. Different levels of the subprogram are called until it returns a 
value for a simple case. Then, the pending subprogram calls are evaluated in turn up to the first level. 
Using numbers in place of subprogram calls, the diagram becomes: 


5 
~ 
3 + 2 
2 + 1 1 + 1 
1 + 4 


You may have also noticed that the recursive algorithm ran much slower than the iterative one. That is 
because in this case, the recursive algorithm computes many of the intermediate values more than once, 
thus requiring more time than the iterative algorithm to reach the same solution. 
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For many programming problems, the iterative algorithm is the more efficient solution, but this is not 
always the case. Recursive subprograms can be much easier to write and might run faster. However, 
recursive subprograms use a larger amount of memory to store all the variables for each call of the 
subprogram. The above example, while not demonstrating the efficiency of recursion, simply illustrates 
how to write a recursive subprogram. 


User-Defined Functions 


The HP-71 has a sizable set of built-in functions. Although they will meet many of your programming 
needs, you might at times find it necessary to create your own functions. The HP-71 enables you to 
create user-defined functions and use them as you use the computer’s built-in functions. 


A user-defined function can appear anywhere in a program or subprogram. But it can only be used by 
the program or subprogram in which it’s defined. If the computer encounters a user-defined function 
definition when executing a sequence of statements, it skips over the definition. A function can be 
executed only when it is referenced in a numeric or string expression, either in a program or from the 
keyboard. 


Forms of a User-Defined Function (DEF FH, EMO OEF) 


Functions that you create can be simple or very complex. On the HP-71 you can create simple func- 
tions using a single statement, or more complex functions which require more than one statement to 
define. 


Single-Statement Functions. Single-statement functions begin with the DEF FH keywords and in- 
clude an expression that assigns a value to the function. 


simplified syntax 





CIEF FH function name [« formal parameter list>]= expression 


A function name is a single letter, or a letter and a digit, for a numeric function. For a string function, a 
£ must follow the letter or letter-digit combination. The variables appearing in the formal parameter 
list are variable names which can be the same as variable names in any other environment. The formal 
parameters can be used in the expression to assign a value to the function. 


A COEF FH statement can contain up to 14 parameters in its formal parameter list. These formal 
parameters can be simple numeric or string variables only. 


Examples: 
MEF FHTSA,B? = tA-Bo-CAt+B2 
DEF FHALECS2,F#3 = FEO Se, S2+67 & FEDSSet+lie, Se+isd 


DEP PP = ShPo Steer C2 tr eo 
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Multistatement Functions. A multistatement function is delimited by a beginning and an end 
statement. 


simpified syntax 





DEF FH function name [* formal parameter list =] 


| EMO OEF | 


A multistatement, user-defined function has the following general form: 





DEF FHx« formal parameter list: A beginning line. 
Program lines. 

FHx = expression An assignment statement. 
Program lines. 


EHO OEF An ending statement. 


Examples: 
100 DEF FNT(A,B) Defines a function named FHT. 
110 A=A+B 
120 B=A+B 
130 FNT=A+B Assigns a value to the function. 
140 END DEF Ends the function. 
100 DEF FNA$(R$,T$,U$) Defines a function named FHA#. 


110 FOR | = 1 TO LEN(R$) 
120 U$[i,I+1]=R$[11] & US! 


130 NEXT | 
140 FNA$ = U$ Assigns a value to FHA#. 
150 END DEF Ends the function. 
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Referencing a User-Defined Function 


When you use a function in an expression, you are referencing it. To reference a user-defined function, 
include it in an expression as you would one of the HP-71 functions. You can reference a user-defined 
function from the keyboard only if it is defined in the current file. (The program in the current file 
need not be in a suspended state.) 


Examples: 

AF=B$ & FNTECA, BF a 
DISF TEFNI¢To-PI 
H=FHASCPHW OR, Yo +P HR 2 


The parameters in the function reference are similar to the actual parameters in a subprogram call. 
They must match the function’s formal parameters in the order in which they are listed, type for type, 
numeric or string. Numeric or string expressions can be used as actual parameters and, unlike the 
actual parameters in the CHLL statement, the expressions can contain references to user-defined func- 
tions. All actual parameters are passed as value parameters. A user-defined function doesn’t return 
values through the actual parameters. 


Environment of a User-Defined Function 


User-defined functions are accessible only to the program unit in which they are defined. That is, a 
main program or a subprogram can’t reference functions which are defined in another program or 
subprogram. 


A user-defined function can access the variables and channel numbers of the environment in which it is 
defined. The exception to this is that variables declared in the function’s formal parameter list are local 
to that function. Because of this, a user-defined function can’t access a variable of the local environ- 
ment in which it’s defined if it has a variable of the same name in its formal parameter list. 


The following illustration shows that a user-defined function has its own environment consisting of its 
formal parameters, subroutines, and FOF ...HET loops. The elements of the user-defined function’s 
environment aren’t accessible to the program or subprogram, but the elements of the program’s or 
subprogram’s local environment, as well as the elements of the global environment, are accessible to 
the user-defined function. 
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Program and User-Defined Function Environments 


Global Environment Local Environment 


file names variables 

Command Stack arrays 

flags channel numbers 
trap values Statement labels 
timers subroutines 

system settings” FUR ...HE#T loops 


User-Defined 
Function 
Environment 


formal parameters 
subroutines 
FOR... HET loops 





Normally, a multistatement, user-defined function ends with EHO CEE or alternatively, with EH. 
When either of these statements ends a user-defined function, the computer: 


¢ Returns execution to the calling expression. 


¢ Clears the memory associated with the function’s environment. 
A user-defined function also ends when 31! C, EHO SUE, or the end of a file is encountered. 


When debugging a user-defined function, a programmer often includes a FALISE in the function defini- 
tion then references the function from the keyboard. The function becomes suspended when it executes 
the FALISE, enabling the programmer to view the values variables, flags, and other aspects of the local 
and global environments. To continue executing the function, the user presses [f](CONT]. If a function 
is referenced in a keyboard expression and then suspended, only the function will be completed when 
execution resumes; the portion of the expression to the right of the function reference isn’t evaluated. If 
you end a suspended function that was referenced from the keyboard, it does not return a value. 


If you end a suspended function that was referenced from a program and a value was not assigned to 
the function, the function returns to the expression a value of zero if it is a numeric function or a null 
string if it is a string function. 





* Refer to the footnote on page 211. 
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Recursive User-Defined Functions 


Like subprograms, user-defined functions can be recursive. For example, the Fibonacci program can be 
written using a recursive, user-defined function. 


Example: Key in the following program and execute it as you did the other Fibonacci programs. 


The main part of the program is line 50 in the user-defined function, FNF. In this function, a discrete 
value is returned for the simplest cases (inputs of 1 or 2), while the function calls itself recursively for 
inputs greater than 2. Line 50 simply states that the value of the function is 1 if the input is 1 or 2. If 
the input is greater than 2, the value of the function is the sum of the Fibonacci values for the two 
preceding terms in the series. 


Line 40 of the program tests for inputs that are either less than 1 or noninteger. If such an input is 
detected, the function displays a message then ends without being assigned a value. When a numeric 
function ends without being assigned a value, it returns a value of 0. 


10 INPUT “TERM? ”;N Prompts you to enter a term. 

20 DISP “TERM ”;N;“ IS ”;FNF(N) Invokes the user-defined function and displays its 
value. 

30 DEF FNF(B) Defines the beginning of the user-defined 
function. 

40 IF FP(B) OR B<?1 OR B>7?60 THEN 60 Checks for an input error. Since the line that 


assigns a value to the function is skipped, the 
function returns 0. 


50 IF B=1 OR B=2 THEN FNF=1 ELSE Assigns a value to the function. 
FNF=FNF(B-1) + FNF(B-2) 
60 END DEF Ends the function definition. 


The algorithm for this program is similar to that used earlier when a subprogram was called 
recursively; however, this function is shorter and easier to follow. 
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Overview 


When you write BASIC programs, you might need to control how information is displayed or printed. 
You can use a few simple techniques or, if you are an advanced user, some advanced techniques. This 
section describes printer and display formatting on the simple to the advanced levels. More specifically 
this section covers: 


e Sending information to a display and a printer. 

e Encoding information to be displayed or printed with formatting instructions. 

e Using format strings and IMAGE statements to format output. 

e Controlling the line width of the display and printer. 

¢ Controlling the end-of-line sequence used by the display and printer. 

e Controlling the display and the printer using control codes and escape sequences. 


e¢ How to create and use protected fields in the display. 
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Simple Formatting 


Displaying and Printing Information (C.I SF, FR IHT) 


You can use the D1SF and FF IHT statements to display information on the HP-71. If you have a 
printer connected, the FF'IHT statement sends information to it. Information that is displayed or 
printed is collectively referred to as output. Also, output can mean to send information to the display or 
a printer. 


simplified syntax 








CiISF display list 


simplified syntax 


FRIHT print list 





The display list and print list are of the same format and each contains a list of items to be output. List 
items can be: 


e Variables and array elements. 
e Numeric expressions. 
e String expressions. 


The items in either list are evaluated and displayed on the same line (if possible) according to the order 
in which they are listed. 


Examples: 
DISF A: B; Ci#; Ces 
DOISP S#kT-U: LEaNnt 


Numbers which are displayed using DISF or FEINT are formatted according to the current display 
format. (Numeric display formats are described under “Number Formatting,” page 54.) 
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implied O 1 2F 


In most cases, the display list does not need to be preceded by [11 SF. For example, typing A# 
is equivalent to typing OISF A#([ENDLINE]. This can save you keystrokes when keying in a program. 
For example, the program line 


14 "BACKE "&CHRS¢ S208 "SLASH" 
would be interpreted and displayed by the HP-71 as 


1 


ml 


DISP “BACE "&CHRE¢ 3298 "SLASH" 


The implied (iI SF doesn’t apply after THEH or ELSE in an IF... THEW or IF... THEN...ELSE 
statement. Since an implied GOTO can be used in this case (refer to “Conditional Branching,” page 
187) the computer interprets a string expression following THEM or ELSE as a label to which execu- 
tion should branch. Therefore, you must key in 01SP after THEH or ELSE when you want it executed 
in a conditional execution statement. 


You should be careful when entering an expression from the keyboard in such a way that it can be 
interpreted as a program line. If a line keyed into the display begins with a number, the computer trys 
to evaluate it as an expression. If the computer is unsuccessful, it then tries to evaluate the information 
as a program line. For example, 1£1 is evaluated as 14 while 1 E1 is interpreted as the program line 
1 DISF Et. 


Spacing Output (T AE) 


Spacing between items in a display list or print list can be controlled by the punctuation used between 
items in the list and by THE. 





TAE operates much like a tab key on a typewriter. It simply spaces over to a specified column before 
displaying or printing information. For example, TRAE “153 moves the cursor to column 15 before 
writing the next piece of information. 


If the column number supplied to THE is greater than the current IO TH or FMIOTH setting, the 
HP-71 repeatedly subtracts the current width from the column number until the column number is less 
than the width. For example, if the current }J ID TH setting is 96 (default), 


THEE LLB: 
is interpreted by the computer as 


THE * 2eo 
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Example: 


Input/Result 
DISP "ABC": TABC8>: "OEF" 


Displays the first item, tabs to column 8, then 
displays the second item. 





Spacing can also be controlled by including punctuation between items in the display list or print list. 
The following punctuation marks perform the indicated spacing: 


e Semicolon (;) Allows no spaces between items. 


e Comma (, ) Fills the remainder of the display zone (described below) with spaces. 


A display zone is a 21-character portion of a display line. The display can accommodate a partial 
display zone when its width won’t allow a complete one. Thus, the display with its default width of 96 
characters has five display zones—four of 21 characters and one of 12 characters. If two items are 
separated in a display list or print list by a comma, the first is printed, and if it doesn’t fill its display 
zone, the computer fills the rest of the zone with spaces before displaying or printing the next item. 


Examples: 


Input/Result 
DISP “ABC"; "DEF* 


HECOEF 


DISF "ABC", "DEF" 


Displays the two items with no spacing. 





Displays the first item beginning at column 1 and 
the second item beginning at column 22. 


Scrolls to the left to display the second item. 
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Advanced Formatting 


Using the comma and semicolon as described, you can format output adequately for many applications. 
However, there are some applications for which you won’t be able to control the lengths of strings or 
the magnitudes of numbers to be printed. These uncertainties can make it difficult to print or display 
information in a consistent format. 


The HP-71 enables you to precisely control the manner in which information is displayed or printed. 
Detailed formats can be specified using format strings (described below). 


Example: The following two programs illustrate how formatted output allows you to round values to a 
specified number of decimal places and to position numbers and text for greater readability. 


Formatting with commas, semicolons, and THE: 


10 OPTION BASE 1 

20 DESTROY A1,B1,I,A,B 

30 FOR I=1 TO 4 

40 READ A\(I),B(I) 

50 DISP A(l);TAB(25);B(!) 

60 A1=A1+A(l) @ B1=B1+B(\) 

70 NEXT | 

80 DISP “--------------- ” TAB(25);"--------------~" 

90 DISP “TOTAL =":A1;TAB(25);“TOTAL =”:B1 

100 DATA 5.8052,7,.3737,8.6,4.322,9,679.4646,.8 


iu] 
boi Efi J 
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Formatting with DISF USING and IMAGE (described below): 


10 OPTION BASE 1 

20 DESTROY A1,B1,I,A,B 

30 FOR I=1 TO 4 

40 READ A(\),B(I) 

50 DISP USING 100; A(I),B(1) 

60 A1=A1+A(l) @ B1=B1+ Bil) 

70 NEXT | 

80 DISP USING 110;“TOTAL=’,A1,“TOTAL=’,B1 
90 DATA 5.8052,7,.3737,8.6,4.322,9,679.4646,.8 
100 IMAGE 10X,4D.DD,10X,4D.DD 

110 IMAGE 3X,14“—",3xX, 14“—’/2(3X,7A,4D.DD) 


Output: 
aod YP. BE 
{37 3,66 
4,22 3,88 
Bro, 46 SE 
TOTAL= 6859,49°F TOTAL= 25,48 


What is a Format String? 


A format string is a string of characters which represents an output format. A format string consists of 
one or more field specifiers that are separated by delimiters, which are usually commas. Each data item 
is formatted by a field specifier. Field specifiers are constructed of characters called image symbols that 
define what information appears in each character position, and multipliers that specify how many 
times an image symbol is repeated. Multipliers can also specify how many times a field specifier (or 
group of field specifiers) is repeated. 


Field Specifier 
ae 
40,00,7%8,50.00 
a 
Format String 
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A format string can be a string expression: 
e Included ina DISF WSING or FREINT USING statement: 
DISP UST "40,00,r°"%,50,00"; ALE! 
e Assigned to a string variable and referenced by that variable name: 


HW AS="40,00, 74, 50,00" 


He 
BH DISP USTlHG AS; Al, Bl 


1 


whe 


A format string can also be an unquoted string included in an IMAGE statement and referenced by 
OISF USIHG and FRIWHT USIHG: 


MH DISP USING 1186; Al, Bl 
lf IMAGE 40.00, 7%a,50,.00 


Image symbols are listed and described in the HP-71 Reference Manual under IMAGE in the keyword 
dictionary. 


Using a Format String (IMAGE, OTSPF USING, PREIHT UST) 
Format strings are used by CISF USING and FRIHT USIHG to format output. 
simplified syntax 


DOISP USING format string ; display list 
OISF UslHt line number ; display list 


simplified syntax 


FRIHT UWSsIWG format string : print list 
PFRIHT USING line number ; print list 


Each item in the display list or print list uses a field specifier in the format string. If there are more data 
items than field specifiers, the format string is reused until all items in the display list or print list have 
been formatted. This is useful when, for instance, you want to display a dozen numeric values with the 
same format; your format string can be a single numeric field specifier. Each field specifier must be able 
to accommodate the type of its corresponding data item in the display list or print list. For example, a 
numeric field specifier can correspond only to a numeric data item. If a numeric field specifier’s cor- 
responding data item is a string, an error results. 


As shown above, format strings can be included in DISF USING and FRINT UWSIHG statements or 
assigned to a string variable. Also, formats can appear on a separate program line using the IMAGE 
statement. 
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simplified syntax 
IMAGE unquoted format string 


Example: Using the information on format strings in the HP-71 Reference Manual (listed under the 
keyword IMAGE), build a format string for a list of items to be printed. The items to be output are 
eight six-digit numbers representing the number of apples and prunes produced in four regions of the 
northern Yukon, and two column headings. Print the column headings with four numbers under each 
heading and eight spaces between columns. 


10 OPTION BASE 1 Sets the base option to 1. 

20 PRINT USING 100; “Apples’,“Prunes’ Prints the column headings. 

30 FOR I=1 TO 4 Begins loop. 

40 READ A\(\),B(I) Assigns values from the [IHTA statement to the 
array elements. 

50 PRINT USING 110; A(I),B(I) Prints the values. 

60 NEXT | End of loop. 

100 IMAGE 2(8X,6A)/ Format string for the headings. 

110 IMAGE 2(8X,6D) Format string for the values. 


120 DATA 14857 ,233649,122990,333125 
130 DATA 759982,1243,233219,416627 


To determine which field specifiers to use in the format string, you need to first lay out the information 
to determine the formats you want. For this example the desired output should appear as: 


8 Blanks 8 Blanks 
a al 

Hepples Prunes 

L4s57 224645 
l22598 aoa eS 
fas 3oe L242 
Pose 1lS fieeer 
eal ee od 


6 Digits 6 Digits 
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The format string for the heading requires eight spaces, six character positions, eight more spaces, 
another six character positions, and an end-of-line symbol for a blank line. The symbol for a space is 
4, the symbol for a character position is , and the symbol for end-of-line is ... Using these characters 
for the format, statement 100 becomes: 


lee IMAGE #eeaaaaa, ARAAARA, aaa aaaad, AAR AAAS 


Each set of image symbols is called a field specifier. A field specifier defines how an item from the print 
list is formatted, or defines the spacing between printed items. The eight X’s above specify a field of 
eight blanks. The six A’s specify a field of six characters. Field specifiers are usually separated by 
commas. 


You can shorten the format string by using multipliers. A multiplier that precedes a field specifier 
indicates that the specifier should be repeated that number of times. Thus the IMAGE statement above 
becomes: 


lf IMAGE &SH,6A,8as,6A- 
or more simply, 


160 IMAGE 2¢86¢,6A2- 


The format string for the numeric data requires eight blanks, six digits, eight more blanks, and another 
six digits. The statement becomes: 


li@ TMAGE 2¢52,609 


Controlling the Display and Printer 
Line Width (HJ IOQTH, PH IOTH) 


The WICTH and FHIOCTH statements set the maximum line length for information output to the 
display and a printer, respectively. 


lM IOTH fine length 


FM IDTH line length 
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The fine length can be a numeric expression that evaluates to a number between 0 and 255. 


Note: Values greater than 255 are interpreted as infinite. However, the maximum line length 
for the HP-71B display is 96. If you use a greater value, the end of a long display line may be 
truncated. 


These statements don’t affect how many characters you can type in the display. They determine 
the line length of information displayed by the following statements: 
else 
eQitsrP USING 
PREIHT 
PRIHT USING 
elListT 
e FLIST 


Example: 


Input/Result 


MIOQTH i (ENDLINE] 
"THENTY THREE CHARACTERS" (END LINE] 


TWEHT'Y THR 


The HP-71 displays the first 10 characters. 





The HP-71 displays the second 10 characters. 


The HP-71 displays the last characters. 





The HP-71’s display is the printer device if there isn’t a printer connected. With no printer connected, 
information can be displayed by both (ISF and FRIHT statements. In this case, if you execute 
PI ITLITH, it will only affect the line length of information sent by FF IHT. Similarly, if you execute 
MIOTH, the line length that is set will only affect information displayed with [I SF. 
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Changing the End-Of-Line Sequence (EHOL THE) 


When the HP-71 sends a line of information to a printer (or the display) using FE IHT, it sends a 
following end-of-line sequence, which is a string of up to three characters that tells the printer what to 
do after receiving the line. The default end-of-line sequence has two characters—carriage return (CR) 
and line feed (LF). This default sequence causes a printer to advance one line and position the print 
head to the first column. On the HP-71, this default sequence causes a new line to be displayed. 


You can change the end-of-line sequence to any characters you choose using the EMHOL IHE statement. 


simplified syntax 
EMOLIWE string 


The string is a string expression that evaluates to at most three characters. 


Example: 
ENDLIHE CHREC LS3,&CHREc 1658, Sets the end-of-line sequence to CR, LF, LF, 
CHRE¢ Las causing a double linefeed. 


These two characters, CHE #¢183 and CHER #13: are two of 32 ASCII control characters. Control 
characters are those ASCII characters (codes are 0 through 31) that are used by computers to control 
peripheral devices.* Many devices respond differently to control characters, or do not respond at all. 
Before using control characters, you should refer to the owner’s manual for the device you are using to 
determine how it responds to these characters. 


Cursor and Display Control 


The HP-71 enables you to control the display using certain characters. If you aren’t an advanced user, 
you might not need this information. 


Control Characters and Escape Sequences. You can further control how the HP-71 displays in- 
formation by sending it control characters and escape sequences. Athough some of the effects of control 
characters and escape sequences can be accomplished with some of the HP-71 functions and state- 
ments (such as LITO TH and ENCILIHE), you can develop some advanced techniques for controlling the 
display using these special characters. 


* Character codes are listed under “HP-71 Character Set and Character Codes” on page 322 of the HP-71 Reference Manual. 
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Control characters (which can be generated by special keystrokes, shown below) control how informa- 
tion is displayed. These characters are commonly used by computer systems to control communications 
between them. Control characters aren’t displayed. Rather, the HP-71 recognizes them as instructions. 
To access these characters, you need to first press (9] and another key. The following table lists 
the control characters the HP-71 recognizes, and the keystrokes required to access these characters. 


ASCil 


CHRE co (9 }LCTRL]} (H]} 


CHEE ¢ 12 | none 


CHR#¢135 | (Q)(CTRL) (mM) 
[gJLCTAL ) (9 }(t) 


Display Control Characters 






Description 













Backspace (BS). Moves cursor left one space. 














Linefeed (LF). Displays a new line without moving the cursor. 





Carriage return (CR). Moves cursor to first column. The HP-71 at- 
tempts to evaluate the display line as if you pressed [END LINE]. 
Escape (ESC). Indicates the start of an escape sequence. 













MHRE Et geo 





An escape sequence is a string, beginning with the escape character (ASCII character code 27), that 
represents one or more instructions for a device such as a display or a printer. (The escape character is 
represented in this manual as ESC.) The HP-71’s display responds to several escape sequences. Escape 
sequences that it doesn’t recognize are ignored. Escape characters can be generated in two ways: 


1. As keystrokes which are executed directly from the keyboard. 


2. As character strings which are executed when “displayed.” 


The following table lists the escape sequences that control the display. To execute an escape sequence 
directly from the keyboard, press (9][CTRL](9)[I] then the keys shown in the table below to complete the 
sequence. To store an escape sequence as a character string, use CHF #¢273 to generate the escape 
character and concatenate one of the characters represented by the keys in the table to complete the 


sequence. 
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HP-71 Escape Sequences 


Escape keystrokes 
or character Description 
followed by: 


Moves the cursor to the right one space (same as [>]). 
| Moves the cursor to the left one space (same as [<)). 


Resets (and clears) the display, including the BASIC prompt. 
Moves the cursor to the first column, superimposing it on the BASIC prompt. 


Hee ee 


Clears the display from the cursor position to the end of the line. (Accomplishes 


the same thing as [f]{-LINE].) 
Sets Insert cursor (same as [f][1/R)). 


Deletes the character under the cursor and shifts all characters to the right of the 
cursor one position to the left’ (same as ([f]{-CHAR]}.) 


Deletes character 


Set Insert Cursor. 
Sets Replace cursor (same as [f][1/R)). 


Turns the cursor off. 


(N] 
[0] 
[P] 
[a] 
(R] 


Turns the cursor on. 


| Sets the cursor to the column represented by the character code for an ASCII 
character m. The character code for n is used by video display devices for row 
positioning. Although it has no effect on the HP-71 display, it must be present to 
compiete the escape sequence. 
(g][CTAL ] Moves cursor to right of rightmost character. 


(g|(CTRL](D)] | Moves cursor to leftmost character. 





Example: Switch to the Insert cursor then back to the Replace cursor. 


Input/Result 
(g)CcTRe) (9 }L) LN) Switches to Insert cursor (flashing left arrow). 
(9 (CTRL) (9)(1) [AR] Switches to Replace cursor (flashing rectangle). 


Positioning the Cursor. To set the cursor to a particular column, press 


(s}(cTrL} (SJL (a}L%] 


then key in the character whose character code represents the number of the column which you want to 
move the cursor to. (This sequence is referred to in this manual as the ESC% instruction.) 
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Example: Move the cursor to column 65. 


Input/Result 
(9JLCTRL) (9)[1) (g)[% } Positions the cursor at column 65. 


The character code for an uppercase A is 65.* Therefore the cursor moves to column 65. (This sequence 
requires a second character after the * because it is used by other devices to specify a row to move the 
cursor to. Remember that although the HP-71 doesn’t use the second parameter for its display, it 
requires you to include it.) If a multi-line display device is used, this instruction causes the cursor to go 
to the specified row and column. 


Rather than using the keystrokes to execute escape sequences, you can store those sequences in char- 
acter strings and use them under program control (or assign a sequence to a key). 


Example: Assign an ESC% instruction to the variable A+ so that when executed it moves the cursor 
to column 11 before displaying information. 


Input/Result 
AS=CHREC SPOR AV ACHR ECL LOB A" Assigns an ESC% instruction to Alf. 
A#&"HR-F." Evaluates the display line. 


Displays HF'-*1 beginning at column 11. 





Creating Protected Fields. A particular use of the ESC< (cursor off) and ESC> (cursor on) 
instructions in programs is to write information in the display so that it can’t be overwritten. Portions 
of the display that can’t be overwritten are called protected fields. Information is placed in a protected 
field when it is written to the display while the cursor is off. Information written to the display while 
the cursor is on can be overwritten. 


Executing ESC< turns the cursor off so that information written to the display is protected from 
being overwritten. (ESC> turns the cursor back on.) Information in a protected field can be erased by 
pressing or [END LINE], but it can’t be written over and the cursor can’t be set to any character in 
the protected field (except by using the ESC% instruction). (Protected fields created using the iI H- 
Ub statement, described in section 7, can’t be overwritten in any way.) Also, the HP-71 can’t read 
information that is in a protected field. 


*HP-71 characters and their corresponding character codes are listed on page 322 in the HP-71 Reference Manual. 
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Example: The following program prompts a user to input a hyphenated identification number. Using 
the ESC < (cursor off) and ESC> (cursor on) instructions, the prompt appears as: 


luv - = 


When the user enters the number, the cursor automatically skips over the hyphens. (The computer 
recognizes the hyphenated number as one number without any punctuation.) The following program 
displays the input prompt in a protected field: 


10 DIM P$[40],F$[2],N$[2],S1 Dimensions four variables. 

20 F$=CHR$(27)&* <” Assigns the ESC< instruction to F#. 

30 N$=CHR$(27)&‘>” Assigns the ESC> instruction to H#. 

40 H$=F$&*—’&N§$ Assigns a write-protected hyphen to H#. 

50 P$=“ "&H$& "&H$&" "&FS&“.” Assigns the default string to F #. It contains three 
spaces, a hyphen, two spaces, a hyphen, and 4 
spaces. 

60 INPUT “ID?”,P$;S1 Prompts the user to enter an identification 


number. (IMF LIT is described under “Entering 
One or More Items,” page 241.) 
In this routine, | 
e F = contains the escape sequence which turns the cursor off. 
e +/# contains the sequence which turns the cursor on. 
e H# contains a write-protected hyphen. 
e F £ contains the default string for the IHFLUT statement. 
The information to be displayed in a protected field is preceded by F# to turn the cursor off. The 


spaces (which are to be written over) are preceded by !1# to turn the cursor on. The IHFLIT statement 
in line 60 displays the input prompt and waits for a numeric input. 


To use the routine, key it into a new program file (refer to page 143 if you have forgotten how to do 
this), and execute it. 
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Input/Result 

STO Sets the numeric display format to standard 
format. 

RUN 


Prompts you for a number. Notice the cursor just 
to the right of the question mark. 





4445 


Notice how the cursor skipped over the hyphen. 








lO%444-52-4345.0 
The program accepts the input. 
= Checks the value you just entered. 


d4q 523345 The hyphens weren’t read as part of the input. 





A protected field can be created on either side of the display using the !{ I HICH statement. 


Example: Create a display window enclosed by HF on the left and 71 on the right. 


Input/Result 
MHIOQTHSS8"HR": TABCSL3s "Fi" 
WIHOOWS, 28 


Displays HF and 71. 





Places the BASIC prompt at column 8 of the dis- 
play. The HF and 71 now reside in protected 
fields. 
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Storing and Retrieving Data 
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Overview 


Computer programs operate on data. Programs can obtain data from different sources. These sources 
are: 


e The keyboard. A user can key data into the computer when prompted to by a program. 


240 
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e A program. A program can contain data stored within its lines. 

e A file. Information can be stored in data files. 
This section describes how the HP-71 gets information from these sources. More specifically, this sec- 
tion describes: 

e How a program accepts data items from the keyboard. 

e How to store and retrieve data in a program. 


e How to create data files, how to store data in them, and how to retrieve that data. 


Keyboard Data Entry 


Entering One or More Items (I HF LIT) 


Using the IHFLIT statement a program can assign values entered from the keyboard to variables. The 
IHFLUT statement prompts the user to enter information from the keyboard, then assigns that in- 
formation to specified variables. 


IHPLUT [prompt message [. default string ]:] input list 


The IHFLUT statement contains four parts—the IHF LIT keyword followed by a prompt message, a 
default string, and the input list. The prompt message and the default string are optional, but there must 
be an input list. 


The prompt message must be a quoted string. The default string can be any valid string expression. The 
input list is a list of one or more variable names (numeric, array elements, string, or substring) separated 
by commas. 


The following diagram illustrates the components of an IHF'LIT statement. 


Default Input 
Prompt Message String List 
ro OS, (mm, 


THPUT "ENTER HAME.AGE: ", "BRUCE, 27": We, A 


Keying in Values. When the computer executes I HF LT, it expects the user to key in some data. If 
you are to key in more than one item of data, items must be separated by commas. The order in which 
variables appear in the input list is the order in which the computer expects information to be keyed in. 
For example, if the input list contains a string variable and a numeric variable, you must key in either a 
string expression or an unquoted string (you aren’t required to enclose string information in quotes in 
response to an IHFLT prompt), then either a numeric value or a numeric expression. 
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Example: The following IHFLT statement requires the user to key in a numeric value, a comma, 
another numeric value, another comma, and either an unquoted string or string expression: 


Input/Result 

DESTROY ALL 

TIHPUT A,B, C# Instructs the HP-71 to prompt for some values. 
The HP-71 will accept two numeric values and a 
string. 
The HP-71 prompts you for the data. 

J, 4,ABC You key in two values and a string (the string 


need not be quoted). 
If you had keyed in, for example, 
PBC aa ys 


the computer would have generated an error since it tried to input the string HEC into the variable A, 
which is a numeric variable. 


If you had keyed in 


the computer would not have generated an error. The reason is that the 456 can be assigned to either a 
string variable or a numeric variable. Since, in this example, the 454 is assigned to a string variable, it 
is treated as a string and not a number. | 


Keying in Expressions. In response to an IHF1IT prompt, one can also enter numeric or string 
expressions. However, each expression must evaluate to the same data type as the corresponding 
variables in the IMF LUT variable list. For example: 


Input/Result 
IHFUT ALB. OF Instructs the computer to prompt for two numeric 
| values and a string. 
Prompts for the information. 
4#24+2, D1L+SIHCGe2, Sh Ts You key in two numeric expressions and a string 


expression. 
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Input Prompts. If you use an IHMFLIT statement with only an input list, you will see the ‘* prompt in 
the display when the statement is executed. However, you can write your own special prompt to be 
displayed instead of ‘*. After typing the IHF UT keyword, type in a prompt message (it can be a quoted 
string only), then a semicolon and the input list. 


For example, if you want to prompt with ENTER #, the IHFLIT statement would be: 
INPUT 'EHMTER #': 4 


When the IHFUT statement is executed, the computer displays the prompt message with the cursor to 
the right of it. The prompt message cannot be overwritten (except by using special escape sequences, 
described in section 13) when the user responds to it. | 


Example: 
Input/Result 
THFUT ‘ENTER #': + Instructs the computer to prompt for data. 


Displays the prompt message. 





ENTER #8 


eS Enters a value. 





Default Strings. In some applications you might want an input variable to assume a default value 
when a user doesn’t key one in. You can specify a default string in an IHF UT statement to supply values 
to variables when a user doesn’t key them in. A defauit string is often used when a programmer antici- 
pates a common response to an input prompt. 


A default string appears in the IHFLIT statement as a string expression following the prompt message. 
It is separated from the prompt message by a comma, and is separated from the variable list by a 
semicolon. 





Example: 
Input/Result 
THPUT "ENTER #",. "45": Prompts for an input. 
EHMHTEF #45 Cursor is set to the first character of the default 
string. 
The input variable, H, is assigned the value of the 


default string. 
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Alternatively, you can edit the default string rather than merely pressing [END LINE]. You can key in 
your Own response and even use the command stack to locate and enter a previous expression. 
Input Conditions. While the HP-71 displays a prompt, the following conditions are active: 

e The Command Stack is active, enabling you to use Command Stack lines for input. 


e The and (9][ERRM] keys are active, enabling you to view key assignments and the last error 
message. 


Pressing clears the input line. Pressing again suspends program execution. 


Pressing [f][CONT] continues program execution without changing the values of the variables in the 
input list. 


Pressing [RUN], [f][SST], or (f][CALC] has the same effect as pressing [END LINE]. 


You can type ahead of anticipated input prompts. The keystrokes will be stored in the keyboard 
buffer then accepted as input when the prompt appears. The keyboard buffer holds up to 15 shifted 
and unshifted keystrokes. 


An OH TIMER # condition that expires won’t cause a branch until the input is completed. 


If an CH ERROR condition is active, a branch will occur for an input error. 


e If the wrong type of item is keyed in, the HP-71 reprompts for the correct type of data if an 
CH ERROR condition isn’t in effect. If the HP-71 encounters an error condition when evaluating 
input items, it suspends the program and displays an error message. If it encounters a warning 
condition, it substitutes a default value and continues to execute the program. 


Entering a Display Line (LI HFUT) 


The LIHFUT statement is similar to the IMF UT statement, except that LIHFUUT assigns the in- 
formation in the display to a single string variable. 





The LIHFLIT statement can have a user-specified prompt message and default string in the same way 
as IHFPLT, but its variable list contains only one variable name, the input variable. |. IMF UT assigns the 
entire input to the specified input variable, which must be a string variable. Thus, commas, which nor- 
mally separate items in the input list, can be accepted as part of the input. 
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Example: 


Input/Result 
LIHPUT "TEXT:"; Ag 


Prompts for an input line. 





HEC, DEF, GHI (END LINE] Key in HEC, COEF .GHI for the input line. 
At Displays line just entered. 


HEC, DEF, GHI Shows that the commas were accepted as part of 
the input string. 





Program Data 


Often a program requires data which should not change each time the program is executed. Rather 
than require a user to key in the data, it can be stored directly in program lines. 


Storing Data In a Program (CATA) 


You can store data in a program using DATA. 


simplified syntax 





CATA data items 


The data items are numeric expressions, string expressions, and unquoted strings. They can appear in 
any order, but as in an input list, they must be separated by commas. A [IR TA statement isn’t executed 
by a program. It simply holds data. 


Examples: 
OATH 35.4,79,REVEHUE, INTEREST, 45E61¢ 
DATA TOTAL. FRICE, (AL +B1L 401 oe5, SEC1S oR Loy 


A DATA statement in a program or a subprogram can’t be used by another program or subprogram. 
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Retrieving Program Data (FEAL) 


A program accesses items in LIHTH statements by assigning them to variables using the FEHU state- 
ment. 


simplified syntax 
F'EAO variable list 


The HP-71 maintains a data pointer which points to the next item in a DATA statement to be read. 
When a FEAL statement assigns a data item to a variable, the data pointer is advanced one item. 
When the HP-71 executes a program, the data pointer points to the first item in the first DATA state- 
ment. Successive fF: EAL operations advance the pointer to successive items in the DAHTHA statement. 


When the last item in a CATA statement is read, the data pointer jumps to the first item in the next 
CINTA statement. Successive FEAL operations continue to advance the pointer to successive items and 
successive CATA statements. When the last item in the last OHTA statement in a program or 
subprogram is read, a subsequent FEAL causes an error. It might be helpful to think of the DATA 
statements in a local environment collectively as a large table of data items. (Local environments are 
described in section 12, “Subprograms and User-Defined Functions.”) 


Resetting the Data Pointer (FES TORE) 


You can reset the data pointer within a local environment to the first data item in a DATA statement 
using FES TORE. 


RESTORE [statement identifier] 





Examples: 

RESTORE Sets the data pointer to the first data item of the 
first CATA statement in the program or 
subprogram. 

RESTORE 1886 Sets the data pointer to the first data item of the 
CATA statement on line 1000. 

RESTORE ELECOATA Sets the data pointer to the first data item of the 


CATA statement on the line identified by the la- 
bel, ELECODATA. 
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RESTORE can set the data pointer only within a local environment. If a DATA statement isn’t on a 
line specified by RESTORE, then the HP-71 searches through the higher-numbered lines for a CATA 
statement and restores the pointer to the first item in the DATA statement. If a DATA statement isn’t 
found, the RESTORE statement isn’t executed and program execution continues. 


Data Files 


Many programs generate large amounts of data. This data needs to be stored in a logical format so that 
it can be easily retrieved, added to, changed, or sent to other computers. The HP-71 enables you to do 
this using data files. 


Types of Data Files 
The HP-71 enables you to create three types of data files: 


e DATA files, which can contain numeric and string data. 


¢ TEXT files, which are formatted to be read by other Hewlett-Packard computers, such as. the 
HP-75. 


e SDATA files, which have the same format as data files created by the HP-41 Handheld Computer. 
Although the formats of these files are different, many of the operations on them are similar. There- 
fore, data file operations will be described in general and differences in operations among file types will 
be noted. 

There are several operations involving data files: 

e Creating a file. 

e Opening a file. 

e Closing a file. 

e Storing information in a file. 


e Retrieving information from a file. 
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Creating a Data File (CREATE) 
You can create a data file using TFEATE. 


simplified syntax 





CREATE file type file name [: device] 


The file type must be DATA, SDATA, or TEXT. The file name can be any valid file name and the device 
can be main RAM (default) or an independent RAM. 


You can optionally specify file size, and for DATA files, the record size. (Specifying the record size and 
file size is described under “File Records,” page 256.) When you store information sequentially in a 
data file located in HP-71 memory, the size of the file expands to accommodate the information. There- 
fore, specifying file size is not necessary when creating data files in memory for sequential operations. 


When creating a random access data file, you must specify file size. The file size will not expand when 
you store data randomly; the records you specify in random access operations must already exist. 
(When creating a data file on a mass storage device, you must specify the record size and file size. 
Using data files located in mass storage devices is described in the HP 82401A HP-IL Interface Owner's 
Manual.) 


Examples: 

CREATE DATA TREESTAT Creates a DATA file named TREESTAT. 
CREATE Test LABNOTES Creates a TEXT file named LAEMOTES. 
PREATE SOATA LIWNEFIT Creates an SDATA file named LIHEFIT. 


Opening a Data File (AS51GH #) 
To access a data file, you must first open it using HSSTIGH #. 


simplified syntax 





“IGH # channel number T( data file 


This statement assigns a symbolic channel! number to the specified data file, opening the file. A channel 
is a memory area created by ASS1GH # that contains file control information to facilitate the flow of 
data between the keyboard or a program and the file with which the channel is associated. A channel 
number must be in the range 1 through 255 and can be assigned to only one file. You can assign up to 
64 channel numbers at a time, but each file can be associated with at most one channel at a time. 


If the file you specify can’t be found in memory and no device was specified, the HP-71 creates a 
DATA file in main RAM and assigns the specified channel number to it. Files created in this manner 
are sequential data files whose data cannot be accessed randomly. 
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Examples: 
ASSIGH # 1 TO STOCK: PORT¢43 Opens the file STOCK in port 4 and assigns chan- 
nel 1 to it. 
HSsIGH # 221 TO AF Opens the file indicated by H# and assigns chan- 
nel 221 to it. 
HSSTGH # Br TO WOLTAGES Opens the file OL TAGES and assigns the chan- 


nel indicated by E 7” to it. 


Closing a Data File 


You should always close a file when you finish using it. Closing a file releases the memory (34 bytes) 
associated with a channel. All data files opened by a program or a subprogram are automatically closed 
when that program or subprogram executes EHO or EHO SLB. When you close a file, you are simply 
breaking the association between a channel and a file. 


Data files are closed by the HS1GH # statement when the file name in the statement is one of the 
following: 


ex" 
e + 

Examples: 
ASS 16H <7 TH 
HES IGH # = TO Weg 
HSSTGHM # if To # 


Accessing Data Files 


You can store and retrieve data from a data file either sequentially or randomly. When you store data 
sequentially, the HP-71 places items in the file one after another. Items are kept in the file in the order 
that you store them. Therefore, they can be read from the file in the same order. When storing data 
randomly, items are stored in an arbitrary order. The order in which they exist in the file is not nec- 
essarily the order in which they were stored. When you store data items randomly, you specify where in 
the file you want them stored. 


The HP-71 uses a mechanism called a file pointer to keep track of where the next data item will be 
stored or retrieved in a file. When you store data or retrieve data sequentially, the HP-71 automatically 
moves the file pointer. When you store and retrieve data randomly, you specify the position of the file 
pointer. 
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If you have never used data files before, you might want to read “Storing and Retrieving Data Sequen- 
tially” before you read “Storing and Retrieving Data Randomly.” For beginners it is usually easier to 
learn how to store and retrieve data sequentially before learning how to store and retrieve data ran- 
domly. This is because sequential file access doesn’t require you to keep track of the file pointer—the 
HP-71 automatically does this for you. You only need to remember to reset the file pointer to the 
beginning of the file after storing all your data. (This will be descibed shortly.) 


Storing and Retrieving Data Sequentially 


A list of checks written, or an array consisting of temperature measurements, are examples of items 
arranged in a sequence. If you are going to store data items in a sequence and then recall them in the 
same order, you need to use sequential file access. 
Sequential file access has the following advantages: 

e It is simpler to use than random data access. 

e The computer automatically keeps track of the file pointer. 

e You can store a list of items in a data file regardless of the file’s record size. 


Data items are stored in a file using FR IMT #. To remember this, think of FE IMT # as “printing” 
information on a file. Data items are retrieved, or “read,” from a file using READ #. 


Storing Data Sequentially (FE IHT #) 


Once a file has been created and opened, you can store information in it sequentially using FR IHT #. 


simplified syntax 





FeIHT # channel number : data item list 


The data item list is a list of one or more data items separated by commas. Data items can be numeric 
and string expressions or arrays. (Although you can retrieve numeric and string data from an SDATA 
file, you can store only numeric data in such a file.) Data items are stored in the order in which they 
appear in the list. 


Note: When you store numeric information in a DATA file, the file’s record size must be at least 
eight bytes. If you attempt to store numeric data in a file with a record size smaller than eight 
bytes, an error results. 
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Example: The following program turns the HP-71 into a checkbook register. It sequentially stores the 
amount of a check and who it was paid to in a DATA file. The program prompts you for information 
about each check written and then stores that information. (Another example will use the data file 
created by this program, so you might want to save the data file.) The program stores information for 
as many checks as you want. When you don’t want to enter any further information, type DOHE, 4 in 
response to the prompt and the program will end. Key in the following program (first type 
EOIT CHECK (ENDLINE]) and execute it. 


10 CREATE DATA CHECKS Creates the DATA file CHECES. 
20 ASSIGN #1 TO CHECKS Opens the file by associating it with channel 1. 
30 DESTROY N$,A Ensures that N$ and A are unused. 
40 INPUT “PAID TO,AMT:’:N$,A Prompts for checkbook information. 
50 IF N$=“DONE” THEN ‘DONE’ Ends program if you type CIOHE. 
60 PRINT #1;N$,A Stores checkbook information. 
70 GOTO 30 Prompts for another input. 
80 ‘DONE’: PRINT #1;N$ Stores COME to mark the last entry. 
90 ASSIGN #1 TO x Closes the file by dissociating it from channel 1. 
Input/Result 
RUM CHECK Executes the CHECK program. 
FAIO TO,AMT: Prompts you to enter who you wrote a check to 
and the amount of the check. 
HBC WIRIHG, 16548, 75 You enter paid to and amount. 
FAIO TO,AMNT:E Prompts you for another check. 


COMPUGRILL,18, 35 


PATO TO,AMT: @ 
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ABC GRAPHICS, 1237.65 
PATIO TO,AMNT: @ 
PHOTO CEHTER, 34,5 
FAITO TO, AMT: @ 
DOHE,& You signal the computer that you don’t want to 


enter any further checkbook information. 


In the example above, you can see that you can store a mix of data types in the same file. The program 
stored each piece of check information after the preceding one, keeping them in the order in which 
they were stored. 


The File Pointer and Sequential Access 


The HP-71 uses the file pointer to point to where the next data item will be stored or read in a data 
file. After the HP-71 stores an item, it moves the file pointer to the place in the file where it will store 
the next piece of information. Similarly, the HP-71 moves the file pointer to the next data item after 
retrieving data from a file. 


When a file is opened, the HP-71 places the file pointer at the beginning of the file. When you store 
data sequentially, the computer places the items in the file in the order in which they appear in the data 
item list. When the entire list has been stored, the pointer remains at the end of the recorded data, and 
the end-of-file marker is written after the position of the last item. The HP-71 always writes an end-of- 
file marker after the last data item when data is stored sequentially. 


End-of-File Marker 


Data 


. item item... item item 
File 


File Pointer 
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Execution of a subsequent FF IHT # statement on the same file records data items after the pre- 
viously recorded data and moves the end-of-file marker to the end of the newly recorded data. The file 
size automatically expands, if necessary, to accommodate the new data. 


PRIWT # 109; item, item, ..., item 
End-of-File Marker 


———_—_—_—___» 





Data 


File item item... item item item item ... item 


File Pointer 


The pointer continues moving sequentially through the file as items are added. This continues until the 
file is closed or the pointer is relocated using RESTORE # (described on the next page). 


Note: The movement of the file pointer and end-of-file marker influence the way in which 
sequential files are updated. Thus, when storing data sequentially, always store all your 
information in a file before relocating the file pointer or closing the file. (You can store several 
data items in a record.) But if you close a file, then either reopen it or use RESTORE # to 
position the file pointer to that file’s beginning, then use sequential PRINT # to store data, 
the new data replaces the old data in that record. 


Also, since the HP-71 places an end-of-file marker after a sequential FRIHT #, if the data 
exactly fills one record, the end-of-file marker is placed at the beginning of the next record. In 
this case, all previously stored data beyond the end-of-file marker is also lost to sequential 
READ #. This always applies to TEXT files because each record contains only one data item. 
But for DATA files, where more than one data item can occupy a record, you can use random 
REAOQ # (page 260) to access any data beyond the end-of-file marker. 


The following diagram illustrates how the information from the above example is stored in the data 
file. The position of the file pointer is shown before the file is closed. 


DATA File For the SHEE Program 


End-Of-File Marker 







HEE WIRTHG 


File Pointer 
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Recalling Data Sequentially (FES TORE #, READ #) 


Sequential data is recalled in the order in which it is stored. If you store information in a data file and 
don’t close it, then you will need to move the file pointer to the beginning of the file before you retrieve 
information from it. You can do this using RESTORE #. 

simplified syntax 


RESTORE # channel number 





Examples: | 

RESTORE # i4 Moves the file pointer to the beginning of the file 
associated with channel 14. 

RESTORE # A+E Moves the file pointer to the beginning of the file 


associated with the channel indicated by the 
expression A+E. 


If a file has just been opened, the file pointer is positioned at the beginning of the file. In this case, you 
don’t need to use FES TURE # before reading information from the file. 


Information is recalled from a data file and assigned to one or more variables using READ #. 
simplitied syntax 


RFEAC # channel number : variables 


In this statement, channel number is a valid channel number and variables is a list of one or more 
variables or arrays, separated by commas, that will be assigned values from items in the data file asso- 
ciated with the channe/ number. 


This statement retrieves a data item for each variable listed. Each data item must match the type of 
the variable, either numeric or string, it is assigned to. Successively executing FEAL # reads 
successive data items from the file, assigning them to variables. (The contents of the file aren’t affected 
by this statement.) 


Attempting to retrieve information beyond the end-of-file marker using F}EAOD # results in an error. 


Example: The following program retrieves the checkbook information from the data file CHECK (cre- 
ated in the example on page 251) and displays it one line at a time. To display the check information, 
key in the program and execute it (first type EDIT GETCHECK (ENDLINE)). 


10 DESTROY N$,A,S 

20 ASSIGN #1 TO CHECKS 
30 READ # 1:N$ 

40 IF N$=“DONE” THEN DONE 
50 READ # 1;A 

60 DISP USING 100;N$,A 

70 S=S+A 

80 GOTO 30 

90 DONE: DISP USING 110; S 
100 IMAGE 12A,xX,“$’,5D.DD 


110 IMAGE “TOTAL=’,7X,‘$’,5D.DD 
120 ASSIGN # 1 TO x 


Input/Result 
RUM GETCHECE 


HEE WIRING 
CORMPUGRILL 
HEC GRAPHICS 


jonh 
mt 


Lf] 


FHOTO CENTER 
TOTAL= 


foun 
fe te] ef es CT 


1 lo 
OF 


be 
Pact 
mm fmf mo im 
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Ensures that N$, A, and S are clear. 
Opens the DATA file. 

Reads a paid to name. 

Tests for the last entry. 

Reads a check value. 

Displays paid to and amount. 
Accumulates check totals. 

Loops back and reads another check. 
Displays the total. 


Specifies the image format for displaying 
checkbook information. 


Specifies the image format for displaying total. 
Closes the data file. 


Executes GETCHECE, 


Reads checks from the data file CHEE and 
displays them. 


Computes and displays the total. 


Numeric data in a file need not agree in precision (REAL, INTEGER, SHOFT) with the variables to 
which they are assigned. Numbers retrieved from data files are converted to the precision of the 
variables to which they are assigned. If a READ # variable has a lower precision than the data item 
being read, the data item is rounded to the precision of the variable. Ifa FEC # variable has a higher 
precision, then its magnitude is not changed, but is simply considered a value of the higher precision. 


256 Section 14: Storing and Retrieving Data 


Storing and Retrieving Data Randomly 


Random access enables you to print to, read from, or update a portion of a data file by accessing its 
individual records in any order. Storing and retrieving data randomly is a bit more complex than 
sequential operations. If your applications require only sequential access, you don’t need to read this 
information on random access of files. 


The advantages of using random file access are: 


e You can move the file pointer to any record. This enables you to store and retrieve data in any 
order. 


e An end-of-file marker is not placed in the file after you store a data item in it. 


There are two restrictions that apply to random access of data files: 


e You can store and retrieve data from only one record at a time from a DATA file. (But you can store 
more than one data item in a record.) 


e You can’t randomly store information in a TEXT file. 


File Records 


Each data file is divided into smaller units called records. Using random operations, you can store one 
or more data items in a single, specified record within a DATA file. (In sequential access, data items are 
stored in a DATA file without regard to record boundaries. It is important to keep track of DATA file 
records only when you are using random access.) 


You can store only one data item in an SDATA record. (Remember, you can store only numeric data in 
this type of file.) However, unlike DATA files, you can store information from more than one SDATA 
record with a single FRIHT # statement. Also, you can retrieve information from more than one 
SDATA record with a single FEAD # statement. 


You can retrieve information from a TEXT file using random access or sequential access, but you can 
store information in a TEXT file using sequential access only. The size of a TEXT file record is deter- 
mined by the computer at the time a data item is stored. Each record is just large enough to contain the 
data item it holds. 
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The following table shows the operations that can be performed on each type of data file (indicated by 
an x): 


Allowed Data File Operations 


Random FRIHT # 
Random FEAD # 
Single Record Access 
More Than One Item Per Record 











The record sizes for the different data files are shown in the following table: 


Data File Record Sizes 


256 bytes (default). Can be set by user. 
8 bytes (fixed). 


Set by the computer to the size of the 
data item it contains. 









When you create a DATA file, you can specify the record size and the number of records in the file. 


simplified syntax 





LEEATE file type file name [: device][. file size[. record length]] 





In this statement, file size refers to the number of records for DATA and SDATA files, and the number 
of bytes for TEXT files. The record length refers to the number of bytes per record, which you can 
specify for DATA files only. When you create an SDATA file, you can specify the number of records in 
the file, but the record size you specify is ignored. (The record size is fixed at eight me ) The com- 
puter ignores the record size you might specify for a TEXT file. 


The DATA file is the most versatile file for random access operations. You can specify its file size and 
record length, and can store any type of data in it. 
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Moving the File Pointer (FES TURE #) 


If you want to move the file pointer to a specific record in a data file, execute FESTORE #. 


RESTORE # channel number, [record number] 





Example: 

RESTORE # 1,25 Moves file pointer to the beginning of record 25. 
The ability to move the file pointer is useful when you want to store or retrieve data beginning at a 
specific record. To do this, you can simply position the pointer to the desired record using 
RESTORE #, then read from or store to that file. Using RESTORE # to position the file pointer is 
necessary if you want to store or retrieve data sequentially beginning at a specified record.* But for 


random storing and retrieving operations, it is not necessary to first position the file pointer using 
FESTORE #. | 


When you don’t specify a record number the computer sets the file pointer to the first record (0). 


Storing Data Randomly (PFE IHT #) 


You can store information in a specific record by specifying a record number in the FE IHT # state- 
ment. (This is allowed for DATA and SDATA files only.) 


simplified syntax 





FRIWHWT # channel number, record number; data item list 


Note: When you store numeric information in a DATA file, the file’s record size must be at least 
eight bytes. If you attempt to store numeric data in a file with smaller records, an error results. 


Examples: 
PRINT # 1,8;A Stores A$ in record 0. 
PEIHT # 1,A+B: T#a64 Stores a string in the record indicated by A + B. 


The following example illustrates the movement of the file pointer as a result of random storage oper- 
ations. This example uses a DATA file, which is created with a record length of eight bytes. 


* Sequentially stored data items are often stored in consecutive records when there is not enough room in a single record to 
contain them. For example, part of a string can lie in one record and be continued in the next record. You should keep this in 
mind when moving the file pointer so that data in a file doesn’t become inadvertently altered or lost. 
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Example: Create a DATA file and into it store numeric information relating to the number of foggy 
days recorded by a freighter during four crossings of the Pacific Ocean. 


Input/Result 
CREATE OATA FOGOATA,5S,& 
HssIlGH # i TO FOGDATA 


Ft | ft ft 


A 


File Pointer 
PRIAWHT # 1,2:6 
FRIWT # 1,2:186 


6 10 
0 1 2 3 \ 4 
File Pointer 
FRIHT # 1,8:5 
PREIWHT # 1,1: 
5 3 6 10 
1 4 
File Pointer 
PRIMT # 1,4: "FOG" 
5 3 6 10 FOG 
0 1 2 3 4 


File Pointer 


Creates a DATA file with five 8-byte records. 
Opens the file FOGOATR. 


The file is empty, having just been created. 


Stores © in record 2. 


Stores 1 in record 3. 


The file pointer moves to the beginning of record 
4, 


Stores two more data items. Unlike a sequential 
store, the computer doesn’t place an end-of-file 
marker in the file following a random store. 


The file pointer is positioned after the last item 
stored. 


Stores the string "FOG" in record 4. 


The file pointer moves to record 4 where the 
string FOG is written. 
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After the last operation, the file pointer is positioned inside record 4. If you now attempt to do a 
random store, you could not fill the remainder of record 4, you could only overwrite the information in 
it. However, you can fill the remainder of the record by storing sequential information. This is because 
a sequential store operation places information in the file starting from the current position of the file 
pointer. But, except for highly specialized applications, you should avoid mixing random and sequential 
operations. 


Recalling Data Randomly (FEHD #) 


In the same way that you specify a record number for storing data, you specify the record from which 
you want to retrieve information. A random read operation can retrieve information from one record 
only. 





= simplified syntax 


| REAG # channel number , record number : variables 
You can store and retrieve more than one item in a record in a DATA file. All items to be stored in a 
single record must be listed together in the FE IHT # statement. Storing several items in a single 
record is useful when you store different items in sets and retrieve them with a single FEAL # state- 
ment. For example, if you wrote a program to store a list of telephone numbers, the first name, last 
name, and phone number can be stored as separate items in a single record, provided the record size 
can accommodate the information. The three items can then be retrieved with a single statement such 
as FREAD # 1,4;F%,L4,H#. 


Examples: 
PEAO # 2,5:A,B# Retrieves two items from record 5. 
READ # 5,2#kB-1:H# Retrieves a string from the record indicated by 


2tB-1. 
Attempting to read past the end of the file or past a record boundary generates an error. 


_ A record in a TEXT or SDATA file can contain only one item. But, unlike reading information from a 
DATA file, you can read data from more than one TEXT or SDATA record at a time. 
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Storing and Retrieving Arrays 


An entire numeric or string array can be stored in a data file using a single FRIHT # statement. You 
can use parentheses as shown below to indicate an array in the data item list. You don’t need to specify 
the dimensions of an array (arrays are one- or two-dimensional) when you store it in a data file. The 
HP-71 automatically accommodates an array of any dimension, provided there is enough RAM to store 
all its elements. 


Examples: 

PEITHT # 4; Ac Stores the one-dimensional array, H in the data 
file associated with channel 4. 

PRIHT # 2; T4e,3 Stores the two-dimensional array, T4 in the data 
file associated with channel 2. (The comma be- 
tween the parentheses is required when indicating 
a two-dimensional array.) 

PRINT # 1: E Stores the array E in the data file associated with 


channel 1. The array’s dimensions don’t have to 
be indicated. 


An array is stored as a sequence of data items. Nothing in the file indicates that the data items form an 
array. To avoid confusion, it is often best to dedicate a single data file to an array, then store the array 
sequentially with a single FE IHT # statement and retrieve it with a single FEAD # statement. How- 
ever, there are some applications in which you might wish to recall a sequence of array elements in an 
order different than they were stored. 


When you store an array, the first element in the first row becomes the first data item in the file. Each 
element in the row is stored in order. Elements are stored row by row. 


For example, the following matrix is stored in a data file (assuming the file has been associated with 
channel 1) in the sequence A(1,1), A(1,2), A(1,3)...A(3,4), as shown: 


1 2 3 4 
AV) =|5 6 7 8 
9 10 11 12 


PRIHT # 1:8 


mee OTR ee ee eee 
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Since array elements are stored linearly, they may be retrieved with or without an array format. For the 
array in the example above, the following statements could access those array elements (assuming the 
file is assigned to channel 1 and the base option is 1): 


RESTORE # 1 Assigns the file’s data to the array 6, which has 
OM B&3,43 @ FREAD # i; Be, 3 three rows and four columns. This array is identi- 
cal to A in the example above. 
RESTORE # 1 Assigns the file’s data to the array ©, which has 
HIM Crd, 3s @ FEA # i: Cf, 3 four rows and three columns. 
1 2 38 
5 66 
C(,) = 
8 9 
10 11 12 
RESTORE # | Assigns the file data to the array Ti, which has 
OIM Tle#,63 @ READ # 1: Tit,: two rows and six columns. 


123 4 5 6 


T1 = 
7 8 9 10 11 12 
RESTORE # 1 Assigns the file data to the array *, which has 
DIM #¢1i2> @ READ # 1; X¢> twelve elements. 


PELE Te Se eee eps 


Alternatively, the values in the data file can be read into a list of simple variables, or a subset of them 
could be read into a smaller array. 


RESTORE # i Assigns the first six items in the file to the 
REO #1 Bebb sy Pe Gy Hed variables 0, £, F, G, H, and I. 


O=1Lleb&e =2,F = 3,6 = 4,H =5,1=6 
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Passing Channel Numbers to a Subprogram. 


Often when peforming the same set of operations on more than one data file, it is convenient to write a 
subprogram which will perform those operations. For such a subprogram, all the calling program needs 
to do is open each data file using AS51GN #, then pass the symbolic channel number as a parameter 
to a subprogram which performs some operations on the file. 


Data file channel numbers are passed as parameters to subprograms somewhat differently than 
variables or constants. A channel number in a subprogram’s formal parameter list must be an integer 
constant from 1 to 255 and preceded by a "#" symbol. For example, 


SUE HAMEL O#S2 


declares channel 5 as a local channel number. This channel number will point to the same file as the 
corresponding channel number in the CALL statement’s actual parameter list. (Subprograms, param- 
eter passing, local environments, and calling environments are described in section 12, SUETORI me 
and User-Defined Functions.”) 


The channel number in the actual parameter list can be a numeric expression—however, it must be 
preceded by a # character. 


Examples: The following TALL statements pass a channel number to the SLIE statement above: 
HLL NAME LORE EHS 
CALL WMHANE TC #RS 3? 


The second ALL statement above passes channel 8 to HAIE1i. The data file which is associated with 
channel 8 in the calling program becomes associated with channel 5 in the subprogram. All operations 
performed on channel 5 in the subprogram are performed on the file associated with channel 8 in the 
calling program. If the calling program also has a channel 5, it is unaffected by the channel numbers 
used in the subprogram. Like variable names, a subprogram can duplicate the channel numbers used in 
a main program or another subprogram. 


If no channel numbers appear in the subprogram’s formal parameter list, then channel numbers estab- 
lished by the subprogram are local to that subprogram. If a subprogram doesn’t have a formal param- 
eter list, then any channel numbers it uses are those of the calling program or subprogram. 
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The following table summarizes the extent to which a subprogram shares channel numbers with a 


calling environment. 


Scope of Channel Numbers 


Remorse women [a 


SLE statement with no formal parameter list. | Channel numbers are those of the calling program. 


SUE statement with a formal parameter list | Channel numbers are local to the subprogram. 
that has no channel number. 


SUE statement with parameter list that in- | Channel numbers are local to the subprogram. Channel 


numbers in the formal parameter list become asso- 
ciated with the same files as the corresponding chan- 
nel numbers in a [ALL statement’s actual parameter 


list. 


cludes channel numbers. 
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Serial Number and Operating System Version (7) & =) 


Each HP-71 has a serial number stamped on its underside. You should keep a record of this number. If 
your HP-71 is lost or stolen, the serial number can be useful for tracing and recovery, as well as for 
insurance claims. Hewlett-Packard does not maintain a record of individual owners’ names and com- 
puter serial numbers. 


The EF function returns a ten-character string* that indicates which version of the operating sys- 
tem your comptuer is using. Type VEF # to determine the operating system version of your 
unit. This information is helpful when corresponding with Hewlett-Packard concerning technical 
assistance. 


Environmental Limits 
In order to maintain product reliability, you should observe the following temperature and humidity 
limits of the HP-71. 
e Operating Temperature: 0° to 45°C (32° to 113°F). 
e Storage Temperature: — 40° to 55°C (—40° to 181°F). 
e Operating and Storage Humidity: 0 to 95 percent relative humidity. 
Your computer should not be operated or stored outside of the specified range. Operating or storing the 


computer outside the ranges can decrease its reliability. Maximum reliablity is obtained at normal 
room temperatures. 


Operating Precautions 
Certain electronic circuits in the HP-71 function continuously. Improper operation can either disrupt 
performance in unexpected ways or damage the electronics. Disruption or damage can be caused by: 
e Removing the batteries while the ac adapter is not plugged in (may cause loss of memory contents). 
e Removing plug-in modules while the HP-71 is turned on. 
e Allowing electrostatic discharge to reach the HP-71. 
e Placing the HP-71 in strong magnetic fields. 


e Connecting the HP-71 to equipment that is not supported by Hewlett-Packard for use with the | 
HP-71. 


* If one or more extension ROMs are installed, this string may be longer than ten characters. 
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Observe the precautions listed below. 


CAUTION 


Hold or touch the computer while preparing to install batteries or a plug-in module to neutralize any 
electrostatic charge. This is particularly important for the HP-IL module and card reader ports. 


Do not place fingers, tools, or other foreign objects into any of the plug-in ports. 


Turn off the unit before installing or removing batteries, unless the ac adapter is plugged in. 


Turn off the unit before installing or removing a plug-in module. 





Clock Accuracy 


The system clock is regulated by a quartz crystal accurate to within 3 minutes per month for worst-case 
operating temperatures. A more typical accuracy is 112 minutes per month. The adjustment procedure 
makes possible accuracies of better than 15 seconds per month. The accuracy of the clock crystal is 
affected by temperature, physical shock, humidity, and aging. Optimum accuracy is maintained at 
25°C + 5° (77°F + 9°). When an extreme change in environmental conditions occurs, the clock may 
require readjustment, as described in section 5, page 94. 


Conformance of BASIC Interpreter to ANSI Standards 


The HP-71 BASIC language interpreter conforms to the American National Standards Institute 
(ANSI) definition for Minimal BASIC, except as indicated below. Conformance to the standard was 
verified by the application of the National Bureau of Standards (NBS) test suite to the HP-71 
interpreter. This test suite is available as NBS Special Publications 500-70/1 and 500-70/2 from the 
National Bureau of Standards, U.S. Department of Commerce, Washington, D.C., 20234. 


HP-71 Extensions to Minimal BASIC 


The HP-71 extends Minimal BASIC on the following items (numbers in parentheses refer to the pro- 
gram number in the test suite): 


e Variables and strings are initialized to zero and null string, respectively; reference to them before 
assignment returns default values of 0 for numeric variables and "" (null string) for string 
variables. (#23) 


e The character set has been expanded to include any of ASCII code 0 through 255 (decimal) as valid 
character responses. (#93.1, #102, #112) 
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The HP-71 accepts double and single quotes as input characters in an unquoted string if they are 
not the first character in the response. (#109) 


On program input, the HP-71 accepts blanks at the beginning of a line, and accepts a lack of 
blanks between keywords. After a line has been entered, the interpreter removes extraneous blanks 
and inserts blanks where required for readability. (#187, #190, #191) 


In an assignment statement, the keyword LET is optional. (#185) 


The interpreter provides an invisible EH[ statement at the physical end of a BASIC file, so the 
user need not supply an END statement in a program if flow will naturally go to the last line. In 
addition, the interpreter permits more than one EHD statement in a BASIC program. (#3, #4) 


User-defined functions are not restricted to having lower line numbers than the line where they are 
referenced. (#157, #159, #162) 


The HP-71 permits null data items in DATA statements. (#105) 
FEAO and INFLIT statements allow expressions instead of just constants. (#112) 


The system will not generate an error if the program ends before a FOF statement has found a 
matching HET. (#50) 


HP-71 Deviations From Minimal BASIC 


The HP-71 does not comply with Minimal BASIC on the following items: 


The HP-71 assigns the FCF variables from left to right during the initial entry into the loop. 


Example: The following loop is executed once by the HP-71 (ANSI requires it to be executed six 
times): 


150 J= —2 


160 FOR J=9 TO J STEP J 
170 NEXT J 


ANSI requires that the limit and step be evaluated once upon entering the loop. The HP-71 does this, 
but after setting the initial value. (#48) 


The HP-71 response to input errors and the ANSI requirements are tabulated below. (For 
UEFRULT ExTEHMD responses, refer to the keyword dictionary entry for DEFALILT in the HP-71 
Reference Manual.) 
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Responses to Input Errors—HP-71 Versus ANSI 


Numeric underflow. Warning: system supplies | Error: user must No warning or error. 
zero. reenter value. System supplies zero. 
Numeric overflow. Warning: system supplies | Error: user must Error: user must 
its largest signed value. reenter value. reenter value. 








String overflow. Trappable; otherwise fatal. Allows reenter. 

Variable assignment error. | Checked after each item verified. Checked after all 
items verified. 

Execution error. Trappable; otherwise fatal. User must reenter 
input line. 


e If a Minimal BASIC program contains the following statement: 
IHPUT I, AtI3, 
and the user response is: 
1,2, 'abc' 
then the 'sakc' is invalid input and ANSI requires that I and H« I> not be assigned until all 
input is correct. The HP-71 will request the user to reinput his data, but I and H« I+ will have 
the current values of 1 and 2 respectively. If the user now inputs =, 2, 4 then AH‘ 1: has the 
value 2, and H« 22> has the value 3. ANSI requires that H« 12 is yet to be defined and At 23 =3. 
(#108.3) 


e Minimal BASIC requires &.. to provide a warning and to return an overflow value. The HP-71 
gives an error for H.4. (#28) 


e A Minimal BASIC program assumes OF TION BASE & unless ODFTIOH BASE 1 is executed 
as a program statement before any array is declared. An HP-71 program assumes the 
OPTION BASE setting already in continuous memory when the program starts. To avoid uncer- 
tain program performance, an HP-71 program using arrays should include an QFTIOH BASE 
statement (page 68). (#56) 


e A Minimal BASIC program assumes radians setting unless DEGREES is executed as a program 
statement. An HP-71 program assumes the angular setting already in continuous memory when 
the program starts. To avoid uncertain program performance, an HP-71 program requiring an an- 
gular setting should include either a RADIAWHS or a DEGREES statement (page 50). (#120) 
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e A Minimal BASIC program uses the same random number sequence each time it’s run, unless a 
FAHOOMI=E statement is executed as a program statement. An HP-71 program uses a different 
random number sequence each time it’s run. However, an HP-71 program will use the same random 
number sequence each time it’s run when a RANCIOMIZE numeric expression statement (page 52) 
is executed as a program statement. The result of the numeric expression determines what random 


number sequence is used each time the program runs. (#130) 


e A Minimal BASIC program declares variables according to the DIM statement, whether or not 
program control flows through that DIM statement. The HP-71 requires program control to 
flow through a program’s DIM statement. Otherwise the variable declarations will not occur. 


(#62). 
Power Supply Information 


Power Consumption 


The HP-71 consumes the least power when the display is turned off (after OFF, &'E, [f](OFF], or the 
10-minute timeout period elapses). More power is consumed while the HP-71 is turned on, and more 


yet while a program is running or the beeper is sounding. 


While the HP-71 is turned off, it draws a current of about 0.03 mA; while on, but not running, it 
draws 0.75 mA of current. With a typical program running or the beeper sounding, the computer 
draws 10mA. New alkaline batteries will operate an HP-71 equipped with four memory modules for 
at least 60 hours of continuous operation (running typical programs) at room temperature 
(approximately 25°C or 77°F) before the BAT (low battery) annunciator first turns on. 
Rechargeable batteries will deliver a somwhat shorter period (and will not be recharged while in 
the HP-71). If a card reader or HP-IL interface is installed, battery life is shortened by an amount 
determined by module use. 


Turn the HP-71 off before connecting the unit to a power outlet. This will prevent unexpected voltage 
“spikes” from disturbing the contents of memory. When connected to a power outlet, the HP-71 uses 
the batteries as a backup power supply and normally doesn’t draw any power from them. You won’t 
damage the HP-71 by using the computer without batteries, but you may lose everything in memory 


should there be a power outage or an intermittent connection to the voltage source. 


Low-Battery Safeguards 


The HP-71 has low-power safeguards to protect the contents of memory. After the first indication of 


low power, replace the batteries as soon as you can. 


e If battery voltage drops below the operating minimum, the BAT annunciator turns on. This 
indicates that the computer can run a program for 5 minutes to 2 hours more, depending on 
battery condition. 


e The computer will continue to operate after the BAT annunciator comes on. Continued operation, 


however, may result in a memory reset if the batteries run too low. 
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e The card reader may not function properly in a low-battery condition. Although card reader oper- 
ations might not be aborted, the HP-71 will display the message 


WEA: Low Battery 
if card reader operations are performed during a low-battery condition. 
Replacing the Batteries 


The HP-71 uses four size AAA alkaline batteries. When you remove the batteries, you have at least 30 
seconds to replace them, provided you do not press any keys, before the contents of the computer’s 
memory are lost. If you press any keys while batteries are removed, memory contents are immediately 
lost. If you have an ac adapter connected to the HP-71, you do not have to worry about possible mem- 
ory loss when changing the batteries. If you are going to change the batteries without the ac adapter 
being connected, you may first want to copy your files onto magnetic cards or a mass storage medium 
to prevent them from being lost should a memory loss occur. 


To install batteries in the HP-71: 
1. Turn off the HP-71. Press [f][OFF] or type (FF [END LINE]. 


2. Turn the computer upside down and set it on a soft, flat 
surface. 


3. Using your thumb press down on the battery compartment 
door (the door to the center compartment), and slide it toward 
the rear of the computer. When you press down on the 
compartment door, the catch will snap as it unlatches from the 
computer. 





4. Remove the four batteries, and insert four fresh ones, being careful to align them according to the 
indicators in the compartment. 


5. Lay the compartment door in position and slide it toward the front of computer until the catch 
snaps. 


General Cleaning Information 


The HP-71 can be cleaned with a soft cloth dampened either in clean water or in water containing a 
mild detergent. Don’t use an excessively wet cloth or allow water inside the computer. Avoid abrasive 
cleaners, especially on the display window. 
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Plug-In Modules 


Your HP-71 has four external ports for RAM and ROM modules, one port for a card reader module, 
and one port for an HP-IL interface. Before shipping, each of these ports is fitted with a removable, 
blank module to protect the underlying circuits. These ports should be kept covered when not in use to 
prevent foreign matter from entering the HP-71. 


Instructions for installing and using optional memory modules, preprogrammed modules, and the 
HP-IL module are included with each of those modules. Instructions for the card reader module are 
located in Appendix C in this manual, page 284. 


Verifying Proper Operation 


If you suspect that your HP-71 is not operating properly and may require service, you can do the 
following self-test in the specified order: 

1. Turn the computer off. (Press [f][OFF] or execute OFF.) 

2. Plug an ac adapter into a power outlet then connect it to the computer. 
3. Turn the computer back on. (Press [ON ].) 
4 


. Execute the FI function. Type FI (ENDLINE]. The result 2. 141593265253% should be displayed, 

which indicates that approximately 60% or more of the computer’s circuits are operating properly. 

5. If the computer repeatedly fails to perform a particular operation, such as copying a file to a mag- 

netic card, or repeatedly displays an error message, such as Excess Chars, then carefully 

reread the instructions in this manual regarding that operation; you may be specifying the oper- 
ation improperly. 


6. If the computer still does not operate properly, press and simultaneously , then press 
to execute a level one initialization. The display should now display the Replace cursor 
(BASIC mode) or Insert cursor (CALC mode). 


7. Press (simultaneously) then (2](END LINE], to execute a level 2 initialization (IHIT:; =). 
The computer will do a self-test of its circuitry. The computer will display FOM TEST 1 as it 
begins to test the circuits. When the first portion of the test verifies the proper operation of the 
circuits, the computer will display 


ROR TEST iG sé, 

indicating that it is continuing the test. When the test is completed, the computer will display 
ROM TEST 1G 26 36 46 

if the test revealed no faulty circuits. If faulty circuits are detected, at least one of the numbers will 
be followed by a B instead of a G. Thus, 

ROM TEST 16 26 26 46. 
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would indicate that the computer has a faulty ROM. If your computer indicates a faulty ROM 
after an IHIT: = test, it requires service. 


8. If the display remains blank when is pressed, or if characters remain “frozen” in the display, 
then reset the memory: 

Unplug the ac adapter. 

Remove all modules. 

Remove the batteries. 

Press and hold down for about 30 seconds to discharge the circuits. 

Install batteries or connect the ac adapter, then press to turn the computer on. The 

message Memaru Lost should now be in the display. Pressing any key should display the 

BASIC prompt and Replace cursor. 


cao of 


If you cannot determine the cause of difficulty, write or telephone Hewlett-Packard at an address or 
phone number listed under Service, starting on page 276. 


Limited One-Year Warranty 


What We Will Do 


The HP-71 (except the batteries and damage caused by the batteries) is warranted by Hewlett-Packard 
against defects in materials and workmanship affecting electronic and mechanical performance for one 
year from the date of original purchase. If you sell your unit or give it as a gift, the warranty is trans- 
ferred to the new owner and remains in effect for the original one-year period. During the warranty 
period, we will repair or, at our option, replace at no charge a product that proves to be defective, 
provided you return the product, shipping prepaid, to a Hewlett-Packard service center. 


What Is Not Covered 


The batteries or damage caused by the batteries are not covered by this warranty. However, certain battery 
manufacturers may arrange for the repair of the HP-71 if it is damaged by the batteries. Contact the 
battery manufacturer first if your HP-71 has been damaged by the batteries. 


This warranty does not apply if the product has been damaged by accident or misuse or as the result of 
service or modification by other than an authorized Hewlett-Packard service center. 


No other express warranty is given. The repair or replacement of a product is your exclusive remedy. 
ANY OTHER IMPLIED WARRANTY OF MERCHANTABILITY OR FITNESS IS LIMITED 
TO THE ONE-YEAR DURATION OF THIS WRITTEN WARRANTY. Some states, provinces, 
or countries do not allow limitations on how long an implied warranty lasts, so the above limitation 
may not apply to you. IN NO EVENT SHALL HEWLETT-PACKARD COMPANY BE LIABLE 
FOR CONSEQUENTIAL DAMAGES. Some states, provinces, or countries do not allow the exclu- 
sion or limitation of incidental or consequential damages, so the above limitation or exclusion may not 
apply to you. 
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This warranty gives you specific legal rights, and you may also have other rights which vary from state 
to state, province to province, or country to country. 


Warranty for Consumer Transactions in the United Kingdom 


This warranty shall not apply to consumer transactions and shall not affect the statutory rights of a 


consumer. In relation to such transactions, the rights and obligations of Seller and Buyer shall be 
determined by statute. 


Obligation to Make Changes 


Products are sold on the basis of specifications applicable at the time of manufacture. Hewlett-Packard 
shall have no obligation to modify or update products once sold. 


Warranty Information 


If you have questions about this warranty, please contact Hewlett-Packard at one of the following 
locations. 


In the United States. Call (503) 757-2002 or write to: 


Hewlett-Packard Co. 
Calculator Service Center 
1030 N.E. Circle Blvd. 
Corvallis, OR 97330 


In Europe. Call (022) 83 81 11 or write to: 


Hewlett-Packard S.A. 
150, route du Nant-d’ Avril 
P.O. Box CH-1217 Meyrin 2 
Geneva 
Switzerland 


Note: Do not send computers to this address for repair. 
In other countries. Call (415) 857-1501 in the U.S.A. or write to: 


Hewlett-Packard Intercontinental 
3495 Deer Creek Road 
Palo Alto, California 94304 
U.S.A. 


Note: Do not send computers to this address for repair. 
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Service 


Hewlett-Packard maintains service centers in most major countries throughout the world. You may 
have your unit repaired at a Hewlett-Packard service center any time it needs service, whether the unit 
is under warranty or not. There is a charge for repairs after the one-year warranty period. 


Hewlett-Packard products are normally repaired and reshipped within five (5) working days of receipt 
at any service center. This is an average time and could vary depending upon the time of year and the 
work load at the service center. The total time you are without your unit will depend largely on the 
shipping time. 


Obtaining Repair Service in the United States 


For service in the United States: 


ship your HP-71 to: Hewlett-Packard Co. | or mail it to: Hewlett-Packard Co. 
Calculator Service Center Calculator Service Center 
1030 N.E. Circle Blvd. P.O. Box 999 
Corvallis, OR 97330 Corvallis, OR 97339 


The telephone number for the Calculator Service Center is (503) 757-2002. 


Obtaining Repair Service in Europe 


Service centers are maintained at the following locations. For countries not listed, contact the dealer 
where you purchased your unit. 


AUSTRIA BELGIUM DENMARK 
HEWLETT-PACKARD Ges.m.b.H. HEWLETT-PACKARD BELGIUM SA/NV HEWLETT-PACKARD A/S 
Kleinrechner-Service Woluwedal 100 Datavej 52 
Wagramerstrasse-Lieblgasse1 B-1200 Brussels DK-3460 Birkerod (Copenhagen) 
A-1220 Wien (Vienna) Telephone: (02) 762 32 00 Telephone: (02) 81 66 40 


Telephone: (0222) 23 65 11 


EASTERN EUROPE 


Refer to the address listed under Austria. 


FINLAND 
HEWLETT-PACKARD OY 
Revontulentie 7 

SF-02100 Espoo 10 (Helsinki) 
Telephone: (90) 455 02 11 


FRANCE 

HEWLETT-PACKARD FRANCE 
Division Informatique Personnelle 
S.A.V. Calculateurs de Poche 
F-91947 Les Ulis Cedex 
Telephone: (6) 907 78 25 


GERMANY 
HEWLETT-PACKARD GmbH 
Kleinrechner-Service 
Vertriebszentrale 

Berner Strasse 117 
Postfach 560 140 

D-6000 Frankfurt 56 
Telephone: (611) 50041 
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ITALY 

HEWLETT-PACKARD ITALIANA S.P.A. 
Casella postale 3645 (Milano) 

Via G. Di Vittorio, 9 

Il-20063 Cernusco Sul Naviglio (Milan) 
Telephone: (2) 90 36 91 


NETHERLANDS 

HEWLETT-PACKARD NEDERLAND B.V. 
Van Heuven Goedhartlaan 121 

NL-1181 KK Amstelveen (Amsterdam) 
P.O. Box 667 

Telephone: (020) 472021 


NORWAY 

HEWLETT-PACKARD NORGE A/S 
P.O. Box 34 

Oesterndalen 18 

N-1345 Oesteraas (Oslo) 
Telephone: (2) 17 11 80 


International Service Information 


SPAIN 

HEWLETT-PACKARD ESPANOLA S.A. 
Callie Jerez 3 

E-Madrid 16 

Telephone: (1) 458 2600 


SWEDEN 

HEWLETT-PACKARD SVERIGE AB 
Skalholtsgatan 9, Kista 

Box 19 

S-163 93 Spanga (Stockholm) 
Telephone: (08) 750 2000 


SWITZERLAND 
HEWLETT-PACKARD (SCHWEIZ) AG 
Kleinrechner-Service 

Allmend 2 

CH-8967 Widen 

Telephone: (057) 31 21 11 


UNITED KINGDOM 
HEWLETT-PACKARD Ltd 
King Street Lane 
GB-Winnersh, Wokingham 
Berkshire RG11 5AR 
Telephone: (0734) 784 774 


Not all Hewlett-Packard service centers offer service for all models of HP products. However, if you 
bought your product from an authorized Hewlett-Packard dealer, you can be sure that service is avail- 
able in the country where you bought it. 


If you happen to be outside of the country where you bought your unit, you can contact the local 
Hewlett-Packard service center to see if service is available for it. If service is unavailable, please ship 
the unit to the address listed above under “Obtaining Repair Service in the United States.” A list of 
service centers for other countries can be obtained by writing to that address. 


All shipping, reimportation arrangements, and customs costs are your responsibility. 
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Service Repair Charge 


There is a standard repair charge for out-of-warranty repairs. The repait charges include all labor and 
materials. In the United States, the full charge is subject to the customer’s local sales tax. In European 
countries, the full charge is subject to Value Added Tax (VAT) and similar taxes wherever applicable. 
All such taxes will appear as separate items on invoiced amounts. 


Computer products damaged by accident or misuse are not covered by the fixed repair charges. In these 
situations, repair charges will be individually determined based on time and materials. 


Service Warranty 


Any out-of-warranty repairs are warranted against defects in materials and workmanship for a period 
of 90 days from date of service. 


Shipping Instructions 
Do not return any batteries in or with the computer. Please refer to Battery Damage on page 279. 


Should your unit require service, return it with the following items: 
e A completed Service Card, including a description of the problem. 


e A sales receipt or other proof of purchase date if the one-year warranty has not expired. 


The product, the Service Card, a brief description of the problem, and (if required) the proof of pur- 
chase date should be packaged in adequate protective packaging to prevent in-transit damage. Such 
damage is not covered by the one-year limited warranty; Hewlett-Packard suggests that you insure the 
shipment to the service center. The packaged unit should be shipped to the nearest Hewlett-Packard 
designated collection point or service center. Contact your dealer for assistance. (If you are not in the 
country where you originally purchased the unit, refer to “International Service Information,” above.) 


Whether the unit is under warranty or not, it is your responsibility to pay shipping charges for delivery 
to the Hewlett-Packard service center. 


After warranty repairs are completed, the service center returns the unit with postage prepaid. On out- 
of-warranty repairs in the United States and some other countries, the unit is returned C.O.D. (cover- 
ing shipping costs and the service charge). 
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Battery Damage 


Do not return any batteries in or with the computer. The batteries or damage caused by the batteries 
are not covered by the one-year limited warranty. 


If your HP-71 is damaged by battery leakage, you should first contact the battery manufacturer for 
warranty information. Some battery manufacturers may repair the computer if it has been damaged by 
leaking batteries. If the battery manufacturer warrants against battery damage, you should deal directly 
with that manufacturer for repairs. If the battery manufacturer does not warrant against battery dam- 
age, you should send the computer to Hewlett-Packard for repair. Whether the computer is under war- 
ranty or not, there will be a charge for repairs made by Hewlett-Packard when the computer has been 
damaged by the batteries. To avoid this charge, contact the battery manufacturer first when your com- 
puter has been damaged by the batteries. 


Further Information 


Service contracts are available. For information about service contracts, please contact the Cal- 
culator Service Center in Corvallis, Oregon. - 


Calculator product circuitry and design are proprietary to Hewlett-Packard. Service manuals are 
not available to customers. 


Potential for Radio/Television Interference (For U.S.A. Only) 


The HP-71 generates and uses radio frequency energy and, if not installed and used properly—that is, 
in strict accordance with the instructions in this manual—may cause interference with radio and tele- 
vision reception. It has been tested and found to comply with the limits for a Class B computing device 
in accordance with the specifications in Subpart J of Part 15 of FCC rules, which are designed to 
provide reasonable protection against such interference in a residential installation. However, there is 
no guarantee that interference will not occur in a particular installation. In the unlikely event that 
your HP-71 does cause interference to radio or television reception (which can be determined by 
removing all power to the HP-71 and then reconnecting the power and turning it on) you are encour- 
aged to try to correct the interference by one or more of the following measures: 


e Reorient the receiving antenna. 

e Relocate the HP-71 with respect to the receiver. 

e Move the HP-71 away from the receiver. 

e Plug the ac adapter into a different ac outlet so that the HP-71 and the receiver are on different 


branch circuits. 


If necessary, you should consult your dealer or an experienced radio/television technician for additional 
suggestions. You may find the following booklet, prepared by the Federal Communications Commis- 
sion, helpful: How to Identify and Resolve Radio-TV Interference Problems. This booklet is available 
from the U.S. Government Printing Office, Washington, D.C. 20402, Stock Number 004-000-00345-4. 
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Germany Radio Frequency Interference 


The HP-71 has been tested and complies with VFG 1046/84, VDE 0871B, and similar non-interfer- 
ence standards. 


Should you use equipment that is not manufactured or recommended by Hewlett-Packard, that 
system configuration has to comply with the requirements of Paragraph 2 of the German Federal 
Gazette, Order (VFG) 1046/84, dated December 14, 1984. 


Air Safety Notice (U.S.A.) 


The HP-71 has been tested to the requirements of RTCA (Radio Technical Commission for Aero- 
nautics) Docket 160B, Section 21 and found to comply with those limits. Many airlines permit the 
use of calculators in flight based on such a qualification. However, before boarding a flight, check 
with an airline representative on the carrier’s policy regarding use of calculators in flight. 


When You Need Help 


Technical Assistance. For technical assistance with this product, 


call: (503) 757-2004 or write to: Hewlett-Packard Co. 
8 a.m. to 3 p.m. Handheld Computer and Calculator Operation 
Pacific time Calculator Technical Support 


1000 N.E. Circle Blvd. 
Corvallis, OR 97330 


Product Information. For information about Hewlett-Packard products and prices, contact your lo- 
cal Hewlett-Packard dealer. For the name of the dealer nearest you, or to order free literature about 
Hewlett-Packard products, 


call toll-free: (800) FOR-HPPC or write to: Hewlett-Packard Co. 
(800) 367-4772 Personal Computer Group 
PCG Telemarketing 
10520 Ridgeview Court 
Cupertino, CA 95014 


Appendix B 
Accessories Included With the HP-71 


Your HP-71 comes with each of the following: 
e HP-71 Owner’s Manual. 
e HP-71 Reference Manual. 
e HP-71 Quick Reference Guide. 
e One case for the computer. 
e One keyboard overlay. 
e Four AAA alkaline batteries. 
e Accessory brochure. 
e Service Card. 
The accessory brochure describes optional accessories for your HP-71. For more information, see a 


Hewlett-Packard dealer. If you are outside the U.S., please contact the Hewlett-Packard Sales Office 
nearest you. 


Availability of all accessories, standard or optional, is subject to change without notice. 
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Using the HP 82400A Magnetic Card Reader 


Contents 
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Installing the Card Reader ........ 0.0... ccc cee ete nee ees 285 
Removing the Card Reader ............ 0.0... cece teens 285 
Caring For the Card Reader and Cards ........... 0.0... ccc nee 286 
Cleaning Magnetic Cards .............. ccc eee eens 286 
Cleaning the Card Reader Head ............. cece eee ene es 286 
Marking Magnetic CardS ...... 0... teen eee ees 286 
PF iLOOK “Ata Magnetic-Gard) 322 4.34udswieneede than teed niet oar eee 287 
Pulling Cards Through the Card Reader ........... 0.0... ccc etn es 287 
Card Reader Operations ............ 0... ccc eee ete e eee eees 289 
Copying a Card File to a File in Memory ............. 0.0... 00. e eee eee 291 
Copying a File in Memory to a Card File ............... 0.0.2 cece eee 291 
Protecting a Card (PROTECT, UHPROTECT) ........................., 292 
Using Private Cards (: FCRO) ......... 0... eee 292 
Catalog of a Card File (CAT CHRO) ............. 0... eee 293 
Overview 


This section is for those who have obtained the optional HP 82400A Magnetic Card Reader. It de- 
scribes how to install and operate the card reader. 


You might want to first become familiar with the file operations described in section 6. The informa- 
tion in that section is helpful for understanding how to copy files from one device to another. 
This appendix covers: 

e How to install and test the card reader. 

e Caring for the card reader and magnetic cards. 

e Copying files to and from magnetic cards. 


e Obtaining file information from the card reader. 


284 
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Installing the Card Reader 


1. Turn off the HP-71 (press (f)(OFF]). 
2. The card reader fits in the port which is to the right of the display and above the numeric keys. 


. Turn the HP-71 over again. Orient the card reader 


Turn the HP-71 over and remove the door to the card reader port, by pressing down on the door 
and sliding it to the rear of the HP-71. 


. Turn the HP-71 right side up. With your thumb, push 


on the plastic insert that is in the port until it drops 
out. You may want to save this insert in case you re- 
move the card reader. 


with its label facing into the port and its pin socket 
aligned with the pin connectors. Press on the card 
reader near the pin socket until it snaps into place. 





Note: The pin socket might fit tightly over the pin connectors, requiring you to push hard on the 
card reader when installing it. Although the card reader fits snugly into the port, you should ensure 
that you don’t force it into the port if it isn’t properly aligned over the contacts. 


5. Replace the door to the port. 


Removing the Card Reader 


To remove the card reader: 


dis 


mH Pe wo 


Turn off the HP-71 (press [f][OFF ]). 
Remove the cover to the card reader port. 


. Push with your thumb on the labeled side of the card reader until it drops out of the port. 


. Replace the plastic insert. 


Replace the port cover. 
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Caring for the Card Reader and Cards 


Cleaning Magnetic Cards 


Clean cards are necessary for optimum card reader performance. Card surfaces are susceptible to dust 
and oil accumulation, which interferes with the transfer of information to and from the HP-71. A 
common source of dirt and oil is your fingers. Handle cards by their edges only. You can clean cards 
with a soft, clean, lint-free cloth moistened with isopropyl alcohol. 


Place the card on a smooth, clean surface, then wipe the 
cleaning cloth firmly across the magnetic surface (the 
unlabeled side) of the card. 


Creasing, bending, or scratching a card can damage it be- 
yond repair. As a protective measure, you could duplicate 
your important card files and place the duplicates in a 
card holder in a secure location. If one of your working 
cards should be damaged, you'll have a back-up copy 
available. 





Cleaning the Card Reader Head 


The card.reader head is similar to an audio recording head. As such, dirt or foreign matter collected on 
the head can impair the contact between the head and magnetic cards. Dirty cards passed through the 
card reader will impair the quality of its operations. You can clean the head by pulling the abrasive 
head cleaning card (supplied with the card reader) through the card reader in the direction of the arrow 
one-or two times. It’s unnecessary to execute any statements before passing the head cleaning card 
through the card reader. 


CAUTION 


Use of the abrasive card should be necessary no more than a few times during the life of the card 
reader. Frequent use of the abrasive card can cause excessive head wear. 





Marking Magnetic Cards 


You can label the face of a card using any writing implement that doesn’t emboss the card. Permanent 
ink felt-tip pens (such pens usually have the words permanent, waterproof, or smearproof on them— 
don’t use water-based overhead projector pens or ordinary felt-tip writing pens), capillary or technical 
drawing pens using permanent ink, and pencils work well for marking cards. Most inks must be al- 
lowed to dry for a few seconds. Pencil can smear, but is erasable. 
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A Look at a Magnetic Card 


Kach magnetic card has two data tracks, both of which record the following information: 
e The catalog entry of the file recorded on the track. 
e The total number of tracks in the file. 
e The identification number of this track, a number from 1 to the total number of tracks. 
¢ The write-protection status of the track; that is, whether the track is protected against recording. 


e Up to 650 bytes of the file itself. One track can contain information from one file only. One card 
can contain information from one or two files. 





Space to label the card. The direction of movement ay 
through the card reader. 


When passing either track of a card through the card reader, always have the printed face of the card 
up. The order in which you read the tracks doesn’t matter. 


Note: Keep magnetic cards clean and free of oil, grease, and dirt, and handle cards by their edges 
only. Dirt and fingerprints degrade the performance of the card reader, cause warning messages to 
occur, and decrease the lifespan of cards. Cards can be cleaned with isopropyl alcohol and a soft 
cloth. Keep cards away from sources of strong magnetic fields, such as permanent magnets, wires 
carrying heavy currents, power transformers, and degaussers (magnetic erasers); magnetism can 
permanently damage the cards. 


Pulling Cards Through the Card Reader 


The HP-71 displays a variety of messages to guide you through card reader operations. All card reader 


operations involve the following steps: 
1. Type a card reader statement in BASIC mode (such as TOF’ TO CARD). 


2. Press to initiate the operation. The HP-71 responds with the appropriate message and 
waits. 


A typical message you’ll encounter is: 


Mert: Align then EHOLH The HP-71 waits for your response. You can press 
to cancel the operation. 
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3. With the card oriented in the forward direction of the desired track, insert the card so that the 
rightmost alignment mark is just beneath the entry slot; the card should protrude past the exit slot 
so that the arrow and box show. Then press a second time. The HP-71 responds: 


Full ilooation 


4, Pull the card through the card reader. The HP-71 allows about 7 seconds for you to start pulling 
the card. A longer time causes the HP-71 to beep, display a warning—F:..W Er r or —and prompt 
you to try again. If you decide not to pull the card, wait until the HP-71 again prompts you to 
Align ther ENOL (about 7 seconds), then press instead. 


5. After you’ve pulled a card through the reader, several HP-71 responses are possible: 


e If you’re copying a file in memory to a card, the HP-71 will prompt you for a second pass of the 
same track: 


Wo: Align then ENOLW 





This time though, the accuracy of the information copied to the track will be verified. If the 
information isn’t verified on the second pass, the HP-71 will display a warning— 
Jar ifwy Fail—and require two more passes of the same track through the card reader, 
once to copy and once to verify. (If the track still fails to be verified, then clean the card or use 
a new card.) 


e The HP-71 will signal you when you are done with each track: 


Trk n Done 


e If the file fills more than one track, the HP-71 prompts you for the next track: 


Wet: Alian then EHOLH 





Full 2£ of on 


The computer is ready for you to turn the card around and read the second track or to insert 
another card. 


Card Reader Operations 
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e If you pull a card too fast or too slowly, the HP-71 displays a warning—Too Fa=t—or— 
Too 3 1oa1u—and prompts you for another pull. If you pull a card very slowly, the computer 
might respond as if no card had been pulled. 


e The HP-71 continues prompting for as many passes as needed. When the operation is com- 
pleted, the BASIC prompt and the cursor will reappear in the display. 


The following statements operate on magnetic cards using the card reader: 


CAT CARO 
LOP'Y file TO CARD 


LOOP’ CREO TO file 


PROTECT 
WHPREOTECT 
RUM i CARD 


CHATH +: CARO 


Displays the catalog information of a card file. 


Copies a file in memory to a magnetic card. A file 
can be a file name and a device name. 


Copies a card file to a file in main RAM. You 
can’t copy a card file to an independent RAM. 


Protects a track from being overwritten. 
Removes the write-protection from a track. 


Loads a program from magnetic cards, designates: 
it as the current file, then executes it. 


Purges the current file, loads a program from 
magnetic cards, designates it as the current file, 
then executes it. 


All card reader statements are programmable. Only FUH : CARD, RUM :FCR Oo, CHAIH : CARO, 


and CHAIH 


: FEO change the current file designation. 


A magnetic card can be specified in an operation by the device names : CARD and : PCRIE. (:FCRD, 
which specifies a private card file, is described below.) CHF is also a reserved word which can’t be used 
as a file name. Both words specify a device in much the same way as FCF T and HAI do when used in 
CF 'Y statements. Copying information to and from cards is not much different from copying to and 
from independent RAM. 


To specify a file on a card, you can use one of the following forms. 


CARO 

:CARD 

PPCRD 

file name :;CAEO 


file name : FRO 
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The following is an example of a typical operation using the card reader. This example assumes the file 


resides on three card tracks. 


CORY CARO TO ACRES 


Read: them EHOLH 


Hliar 





(align card) 


Full Gard 


1 done 





then EHOLH 





(align the card) 





(pull the card) 





then EHWOLA 





(align the card) 





(pull the card) 


Copies a card file to ACRES in main RAM. 
Prompts you to align the card. 


Indicates that you are ready to pass the card 
through the card reader. 


Prompts you to pull the card through. 


Indicates that the HP-71 successfully read the 
card. 


Prompts you to pull another card through. 


Indicates that you are about to pull a card. 


Prompts you to pull the card. 


Indicates that the computer successfully read 
track 2. 


Prompts you to pull another card through. 


Indicates that you are about to pull a card. 


Prompts you to pull the card. 


After reading the last track, the file is stored in 
memory and the BASIC prompt appears. 
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After the HP-71 reads the last track, it no longer prompts for cards. 


The example above shows that when you execute a statement involving magnetic cards, the computer 
first responds with a message such as Read: Align then EH OLH, then prompts you for more 
cards if they are required. 


Copying a Card File to a File in Memory 


When a file that you want to copy is on a card, you must specify the card reader as the source file’s 
device in the COF'’ statement. Executing a form of COF'' file name without specifying the card reader 
as the source device causes the computer to search for the file in RAM and ROM. Files from magnetic 
cards can be copied only into main RAM from the card reader. Once in main RAM, they can be copied 
to another memory device. (You can’t copy a file directly from card to card.) 


Examples: 

COPY CARO TO ROTATE Copies the file from the card to a file named 
ROTATE. 

PORY : CARO TO TRIAHGLE You can use either CAFE or : CARO. 

COPY CARD Copies the card file to a file of the same name in 
main RAM. 

TOP’ LATERAL: CARD Copies the card file LATERAL to main RAM. 

LOPY GRAPHICS: CARD To IMAGES Copies the card file GF AFHICS to IMAGES in 
main RAM. 


Copying a File in Memory to a Card File 


You can copy any RAM or ROM file to magnetic cards. 


Examples: 

COPY ROTATE:PORT<C&2 TO CARD Copies FATATE from port 0 to a card. 

LORY TRIANGLE: MAIH TO : CARD Copies TRIANGLE from main RAM to a card. 

COPY TO CARD Copies current file to a card. 

COPY IMAGES: PORT? a3 Copies INAGES from port 0 to GEFAFHICS on 
TO GRAPHICS: CARD a card. 
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Protecting a Card (FROTECT, UNPROTELCT) 


For some applications you might want to protect a card from being overwritten so that you don’t ac- 
cidentally alter or lose a file. You can protect cards using FROTECT. 


PROTECT 


When you execute this statement, the HP-71 prompts you to pull a card through the card reader. When 
you pull the card through, the HP-71 will encode a write-protect mark on the track. If you want to 
protect the other track, you must execute FRO TECT again and pull the second track through. 


You can remove the file protection from a card by executing WHFPROTECT. 


UHFROTECT 


When you execute UHFROTECT, the HP-71 prompts you to pull a card through the card reader. When 
you pull a card through, the HP-71 removes the file protect mark from the track. 


Using Private Cards (: FCF TD) 


A file copied to magnetic cards can be encoded as a private file using : F CFD instead of : CHED as the 
device for the new file. A program on a private card can be copied and executed only, and not viewed or 
edited. As with files in RAM, the private encoding of a card file can’t be reversed. (Private files in RAM 
are described in section 6 under “Controlling File Access,” page 116.) 


Copying a File to a Private Card. You can make a card file a private file only at the time you copy 
the file from RAM or ROM to the card reader. To do this, type: 


simplified syntax 


COP’ [file name] [{: device] TO [file name] :FCED 





Examples: 
COPY TYPESET:MAIN TO :PCRO Copies T'*PESET in main RAM to a private card. 
CFORY TO ELECTRON: FCRO Copies the current file to ELEC TRUOW on a pri- 


vate card. 


COPY TO :FCRO Copies the current file to a private card. 
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Copying a Private Card to a File. You can copy a private card to a file by specifying CAFO or 
: FCO as the source device in the TOF statement. You aren’t required to specify a private card as a 
source device when copying a file from a private card. When the HP-71 copies a file from a private card, 
that file resides in main RAM as a private file. 


Examples: 

COPY ;:PCRO TO TYFESET Copies the file on a card to the file TY FESET. 
CORY ELECTROH:FCRO Copies ELEC TECH from a card to main RAM. 
COPY CARD Copies the file from a card to main RAM. 


Catalog of a Card File (CAT CARD) 


The CAT CARDO statement enables you to view the catalog information for any card file. 


LAT CARD 


Example: Display the catalog information for a card file named FROG 1. 


(AT CARDO LEND LINE 





Hlign then ENDLH Prompts you to align a card then press [END LINE}. 
(Align card) You have about 7 seconds to pull the card 
through. 


(Pull card) 


FROG &trk ann oof nnn3 Displays the track just passed through. 


Displays catalog information. 





When you try to obtain a catalog of a card that was written on by another computer or a card with an 
unused track, the HP-71 indicates that its file type is zero. 


Subject Index 


Page numbers in bold type indicate primary references; page numbers in standard type indicate second- 
ary references. In addition to the references in this subject index, a complete index to the HP-71 
instruction set grouped by category is located inside the back cover of the owner’s manual. Other lists 
of alphabetized information are in the HP-71 Reference Manual; in particular, the sections titled “Glos- 
sary,” “Keyword Dictionary,” and “Errors, Warnings, and System Messages.” 


A 

AES function, 48 

Absolute value (HE=), 48 

AC status annunciator, 30 

Accessing data files, 249-263. See also retrieving 
program data 

Accessories included with HP-71, 282 

Accuracy of clock, 268 

ACOs function, 52 

AIS function, 52 

Active environment, 211 

FOC statement, 80-82, 87 

Adding data points to statistical array (HOC), 80- 
82, 87 

Adding lines to program, 116, 158 

Addition (+) operator, 47 

AOIJAES statement, 92-93 

ACNIUST statement, 94-95 

Adjusting clock speed (SETTIME, ADJUST, AF, 
EXACT, RESET CLOCK), 94-96 

Adjustment factor for clock, 95-96 

FF statement, 94-95 

Alternate characters, defining, (ZHHESET, 
CHARSET# keywords), 132-135 

Ampersand (%: operator), 73 

AHO logical operator, 62-63 

AHGLE function, 52 

Angular setting flag (-10), 197 

Annunciator flags (-57, -60 through -64), 201 

Annunciators, 15-16, 20, 22, 30 

ANSI standards, conformance of BASIC inter- 
preter to, 268-271 

Arc cosine (ACOS or ACS), 52 

Are sine (RS 1H or ASH), 52 

Arc tangent (AH TAH or ATH), 52 

Arc tangent in proper quadrant (AHGLE), 52 


Arithmetic 
hierarchy, 64 
operators, 47, 64 
Arrays, numeric, 68-71 
Changing dimensions under program control, 70- 
71 
Declaration of, (IM, REAL, SHORT, 
INTEGER), 69-70, 271 
Default dimensions of, 70 
Recalling (retrieving) (FESTORE #, FREAD #), 
261-263 
Setting lower bound of, (GF TIGH EASE), 68- 
69, 70, 270 
Storing (FRINT #), 261 
Arrays, statistical, 78-89 
Adding data points to, (ACL), 80-82, 87 
Calculating means using, (MEAN), 83 
Calculating predicted values using, (FFE), 85- 


86, 89 

Calculating sample correlations using, (CORF), 
84 

Calculating standard deviations using, (=0E'4), 
83-84 


Clearing elements of, (2L=TAT), 78-80, 87 

Declaring (3 TAT), 78-80, 87 

Deleting data points from, (OF OF), 81-82 

Fitting linear regression model using, (LF), 84- 
85, 88 

Recalling (retrieving) from data files 
(RESTORE #, READ #), 261-263 

Storing (FRIHT #), 261 

Summing data points in, (TUTAL), 82-83 





Arrays, string, 71-73 
Changing dimensions of, under program control, 
73 
Declaring (Q1f), 72-73, 271 
Default dimensions of, 73 
Setting lower bound of, (QF TIOH BASE), 72- 
73. See also same entry under arrays, numeric 
Arrow keys 
Left/right ((<], (>]) keys, 15-16 
Up/down (({A], (¥]) keys, 21, 31, 156, 158 
Arrow status annunciators (+, + symbols), 15-16, 
22, 30 
Arrow () symbol ((END LINE] symbol in CALC 
mode), 42-44 
IM function, 52 
st function, 52 
SiSIGH # statement, 248-249 
Assignment (LET) statement, 67, 269 
in CALC mode, 38-39 
Multiple, 67, 146 
Substring, 74 
Assistance, technical, 280 
ATAN function, 52 
ATH function, 52 
key, 16, 31, 153 
HUTO statement, 149 
Automatic 
command execution (S THF TUF), 139-140 
parenthesis matching in CALC mode, 39-40 


“Er "T: [tr 


B 


key, 12, 16, 21, 44 
Backward execution, in CALC mode, 44-45 
Base option flag (-16), 199 
BASIC 
conformance to ANSI standards, 268-271 
Extensions to minimal, 268-269 
files, 99, 143-144 
Merging files, 116 
Minimal, deviations from, 269-271 
Minimal, extensions to, 268-269 
mode, 13-14, 19,37 
mode calculations, 19, 37 
prompt (>), 13-14 
prompt flag (-26), 200 
BAT status annunciator, 30, 271 
Battery, 13, 30, 271-272 
damage, 279 
power consumption, 271 
replacement, 272 
BEEF OFF statement, 32-33 
BEEF OH statement, 32-33 
REEF statement, 32-33 
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Beeper 
flags (-2, -25), 33, 197 
loudness, controlling, 32-33 
BIN (binary) files, 99, 160 
Boolean values, 62 
Branching, program. See program, branching, 
conditional/unconditional 


C 


CALC mode, 18-20, 37-46, 48 
Arrow (4) symbol ((END LINE] symbol in Com- 
mand Stack), 42-44 
Assignment statements in, 38-39 
Backward execution in, 44-45 
comma (,) reminder for argument lists, 40-41 
Command Stack in, 42-44 
Complete expression recovery in, 42-44 
Error recovery in, 42-46 
Features of, 38-44 
Implied result in, 38, 40 
Operations unsupported in, 46, 48 
Precedence of operators in, 41-42 
Single-step execution in ((f][SST]}), 41,42 
Unsupported operations in, 46, 48 
USER keyboard in, 38 
Warning messages in, 46 
CALC status annunciator, 19, 30 
Calculating means using statistical array (MEA), 


Calculating predicted values using statistical array 
(FRED), 85-86, 89 
Calculating sample correlations using statistical ar- 
ray (LF), 84-85, 88 
Calculating standard deviations using statistical ar- 
ray (S0E'!), 83-84 
Calculations, 18-20, 36-64, 78-89 
Calendar, 17, 90-91 
Setting, 17, 90-91 
Years covered by, 90 
ALL statement 
calling subprogram in another file, 210 
executed from keyboard, 150-151, 
executed in program, 180, 205-210 
parameters, 206-209 
Cancelling 
key definitions (DEF KE‘), 128 
trace operations (TRACE OFF), 168 
write-protection of magnetic card 
(UHPROTECT), 289, 292 
CAFO keyword, 289 
Card, magnetic. See magnetic card 
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Card reader, 284-293 
CAT CARDO statement, 289, 293 
CHAIH : CARDO statement, 289 
CHAIH :PCREO statement, 289, 292-293 
COPY CARO TO statement, 289, 291 
CORY To CARO statement, 289, 291 
OF’ TO :FCEO statement, 289, 292 
head cleaning, 286 
Installing, 285 
operations, 289-293 
FROTECT statement, 289, 292 
Pulling cards through, 287-289 
Removing, 285 
RUM +: CARO statement, 289 
FUN +: PCED statement, 289, 292 
LINFRCGTECT statement, 289, 292 
‘CARO keyword, 289 
CAT ALL statement, 102, 118-119 
CAT (CARO statement, 289, 293 
CAT statement. Refer to HP-71 Reference Manual 
Catalog of file(s). See file, catalog 
Categories of numbers (ZLH25), 60 
CETL function, 48 
CFLAG statement, 192-193 
mHATH statement 
executed from keyboard, 151-152 
executed in program, 180-181 
CHAIW : CARO statement, 289 
Chained programs, 151-152 
Channel number (ASSIGH #), 248-249 
Channel number (CALL, SUE), 206, 263-264 
key, 21 
Character 
code, 74-75, 77, 132-135, 268 
Control, 234-239 
display scrolling rate, 26 
set, 132-135, 268 
CHARSET statement, 132-135 
CHARSET# function, 132-135 
CHE function, 75, 77 
CLAIM FORT statement, 107 
CLASS function, 60 
Cleaning information, 272 
Clearing 
display ([ATTN]), 16 
memory, 13-14 
Clock 
accuracy, 268 
Setting (ZETTINE), 17-18, 92-95; (HDJAES), 
92-93 
Speed correction factor, 92-96 
Closing data file (HESIGH #), 248-249 
CLOTAT statement, 78-80, 87 


(Command Stack) key, 31-32 
Code, character, 74-75, 77, 132-135, 268 
Comma (,) reminder for argument lists in CALC 
mode, 40-41 
Comma (.) used for output spacing, 227 
Command execution (automatic) when HP-71 is 
turned on (STHETUF), 139-140 
Command Stack, 31-32 
in CALC mode, 42-44 
Common log (L.GT or LOG1&), 50 
Complete expression recovery in CALC mode, 42- 
44 
Concatenation, statement (#), 22, 67, 146 
Concatenation, string (#:), 73 
Conditional 
execution of program lines. See program, line(s), 
conditional execution of 
program branching. See program, branching, 
conditional 
Conformance of BASIC interpreter to ANSI stan- 
dards, 268-271 
key, 153, 155 
COHT statement, 155 
Continuous-on flag (-3), 197 
CONTRAST statement, 29-30 
Control characters, 234-239 
Controlling 
cursor, 135-136, 234-239 
display, 135-140, 232-239 
file access (SECURE, UHSECURE, PRIVATE), 
117-118 
line width (WIOTH, FH IOTH), 232-233 
printer, 232-234 
Conventions used in manual, 14, 16, 21, 34 
COPY CARO TO statement, 289, 291 
COPY statement, 102, 112-114, 127 
Lory TO CARD statement, 289, 291 
CORP statement, 84 
Correcting errors. See also error recovery 
by clearing display, 16 
in CALC mode, 42-46 
using TRACE FLOW and TRACE WARS, 166- 
171 
with editing keys, 23-26 
mos function, 52 
Cosine (15), 52 
CREATE statement, 248, 257, 259 
Creating data file (CREATE), 248, 257, 259 
Current 
file, 27-28, 100 
line, 154, 158 


Cursor 
control, 135-136, 234-239 
Insert, 19-20, 23 
Moving, 15-16 
Replace, 14, 16 
Curve fitting, 86-89 
Customizing the HP-71, 120-140 


D 


Damage to batteries, 279 
DATA files, 99, 247-264 
Data. See also file, data 
entry, (IHF LUT), 241-244, 269 
entry into statistical array, (ADE), 80-82, 87 
file, accessing, 249-263. See also data, recall 
file, closing (HSSIGH #), 248-249 
file, creation of (ZFEATE), 248 
file, opening (HSSIGH #), 248-249 
file pointer, 252-253, 258 
file, random data recall from (FREAD #), 254- 
257, 260 
file, random data storage into (RESTORE #, 
FRINT #s), 256-263 
file records, 256-260 
file, sequential data recall from (RESTORE #, 
FREAD #), 254-263 
file, sequential data storage into (FESTORE #, 
FRINT #) 250-253, 256-263 
files, types, 247 
pointer, resetting (FES TORE), 246-247 
Program (OHTA, REAQ, RESTORE), 245-247, 
269 
recall from data file. See data file, random data 
recall and data file, sequential data recall 
recall (retrieval) from program (FEAL), 246, 269 
storage in data file. See data file, random data 
storage and data file, sequential data storage 
storage in program (C}ATA), 245 
CATA statement, 245, 269 
Date 
Displaying (CATE), 90-91; (GATE#), 17, 90-91 
Setting (SETOATE), 17, 90-91 
CATE function, 90-91 
QATE* function, 17, 90-91 
Debugging errors, 16, 23, 25-26, 43-46, 165-171 
Decimal to hexadecimal conversion (CiTH#), 48 
Declaring arrays (01M, FEAL, SHORT, 
IHTEGER), 57, 69-71 
MEF FH statement, 218-219 
NEF KEY statement, 28, 121-124 
Default array dimensions, 70 
Default device, 111 
Default files, 110 
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DEFAULT OH/OFF/EXTEHD statements, 58, 
269-270 
Default string (IHMPUT), 243-244 
DEG function, 52 
DEGREES statement, 50, 270 
Degrees to radians (FAL), 52 
DELAY statement, 26, 130, 131, 138, 194 
NELETE statement, 158-159 
Deleting data from statistical array (CF CIF), 81-82 
NESTE statement, 67-68 
Deviations from minimal BASIC, 269-271 
Device 
Default, 111 
names, 110-114 
NIM statement, 69,72-73, 271 
Dimensions, array, 69-73 
LiIl=F statement, 225-227 
Implied, 24, 67, 226 
Quotation marks in, 67 
DISF USTHG statement, 230-232 
NISF# function, 136 
Display 
catalog of file. See file, catalog 
control, 26, 29-30, 135-140, 232-239 
fields, protected, (HIHOOW), 135-136 
fields, protected using escape sequences, 237-239 
file catalog. See file, catalog 
format flags (-13, -14), 198-199 
format statements, 55-56 
graphics (GOISF), 137-139 
key definitions (FETCH KEY, KEYDEF +, 
(vViEW]), 125-126 
line, entering (LIHFUT), 244-245 
list, 230 
program lines (FETCH, LIST, GOTO), [a], (¥)), 
21, 156-158 
Protected, fields. See display, fields, protected 
reading characters from, ((1}I =F #), 136-139 
Reset, 236 
speed, controlling (ELA), 26 
zone, 227 
Display window, 14-16 
Clearing, 16 
line length, 14-15 
Moving, 15-16 
viewing angle (COHTEAST), 29-30 
Displayed number rounding, 56 
Displaying information, 24, 67, 224-239. See also 
display, display window 
CI operator, 47 
Division by zero, 57-60, 270 
Division operator (."), 47 
Double quotation marks, 67 
NTH function, 48 
iS flag, 57-60, 270 
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E 


E symbol, 54-56 
e* — 1 (EXFIH1), 50 
ECIIT statement, 21, 22, 27, 143-144, 156 
Editing 
key definitions (FETCH KE‘), 125 
keys, 15-16, 21 
program, 22-26, 156-159 
ELSE keyword, 188-189 
EHO OEF statement, 219 
key, 13, 31, 42, 158 
End-of line sequence (EHDLIWHE), 234 
EHC statement, 155, 269 
EHC SUE statement, 204-205 
EHMOLIWHE statement, 234 
EH statement, 56 
Engineering display format (EHG), 56 
Entering 
data and expressions (IHFUT), 241-244 
data into statistical array (HOO), 80-82, 87 
display line, (LIHMPUT), 244-245 
program lines, 22-25, 145-149, 269 
Environment 
Active, 211 
Global, 211 
Local, 211 
Main, 211 
Program and subprogram, 153, 210-215 
User-defined function, 220-221 
Environmental limits of HP-71, 267 
Environments, subprogram, 210-215 
Ending, 214 
Restoring, 212-213 
Saved, 211-212 
Equal-to (=) operator, 62 
EFS function, 61 
ERFL function, 175-176 
key, 164-165 
ER FM function, 164-165 
ERFH function, 173-174, 176 
Error recovery 
by clearing display, 16 
in CALC mode, 42-46 
using TRACE FLOW and TRACE VARS, 166- 
167, 171 | 
with editing keys, 23, 25-26 


Error(s) 
Checking, 148 
conditions, 162-177 
Control of. See error(s), program control of 
Math exception, 57-60, 176, 269-270 
messages, 13, 68, 163-165 
messages, recalling ((9)[ERRM], ERE M#), 164- 
165, 175 
Program, control of, (0H ERROR, EFRH, 
EFFL), 171-175 
Run-time, 163-165 
Syntax, 163-164 
types, 163 
Escape sequences, 234-239 
Evaluation order, 64 
ESACT flag (-46), 200 
EXACT statement, 96 
Exception, math. See math exception 
Execute key ((ENDLINE]), 13, 31, 42, 158 
Execute magnetic card program (FUN : CHEE, 
CHAIN : CARD), 289 
Executing program. See program, execute. 
EOF logical operator, 62-63 
EXP ix — 1 (E#FM1) function, 50 
EF function, 50 
EXFMH1 function, 50 
EXFOMEHT function, 50 
Exponential notation (E), 54, 56 
Exponentiation operator (*), 47 
Exponentiation operator, order of precedence, 64 
Expression entry (IHFUT), 242, 269 
Expression recovery in CALC mode, 42-44 


F 


[tf] key, 11 

f status annunciator, 30 

FACT function, 49 

Factorial (FACT), 49 

FETCH EE statement, 125 
FETCH statement, 26, 156-157 
Fibonacci program, 216-218 


File. See also BIN, LEX, BASIC, DATA, TEXT. 
KEY, SDATA, data, file 
Catalog of card (CAT CARE), 289, 293 
Catalog of every (CAT ALL), 102, 118-119 
Catalog of specified (7 AT). Refer to HP-71 Ref- 
erence Manual 
Closing data (ASSIGH #), 248-249 
Controlling, access, (FF IWATE), 117-118 
Copy card, to main RAM (COFY CARD Td), 
289, 291 
Copy (COF’), 102, 112-114, 127 
Copy, to magnetic card (TOF’Y TO CARD), 
289, 291 
Data, accessing, 249-263. See also retrieving pro- 
gram data 
Data, creation (CREATE), 248, 257, 259 
Data, pointer, 252-253, 258 
Data, random data recall from (READ #), 256- 
257, 260 
Data, random data storage into (RESTORE #, 
FRINT #), 256-263 
Data recall. See file data, random data recall and 
file data, sequential data recall 
Data, sequential data recall from (RESTORE #, 
READ #), 254-263 
Data, sequential data storage into 
(RESTORE #, FRIHT #), 250-253, 
256-261 
Data, storage. See file data, random data storage 
and file data, sequential data storage 
Data, types, 247 
Default, 110 
names, 22, 109-110 
names, reserved words for, 110 
Naming BASIC (EDIT), 21-22, 143-144 
naming workfile (HAME), 27, 101, 145 
Opening data (ASSIGH #), 248-249 
operations, 98-118 
pointer, 252-253, 258 
Program, 27, 143-144 
Purge (FUFGE), 115-116, 127 
records, 256-260 
Renaming (FEHANME), 101, 115, 127 
search order, 112 
security (SECURE, UNSECURE, PRIVAT E), 
117-118, 127 
Specify magnetic card (CARD, : CARO, : PCED), 
289-293 
transform between BASIC and TEXT 
(TRAHSFORM), 160-161 
Fitting data to curves, 86-89 
F Ix statement, 55 
Fixed-decimal display format (F 1%), 55 
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FLAG statement, 191-193 
Flag(s), 30, 57-60, 68, 190-201. See also system 
flags 
Clearing, (CFLAG, RESET) 192-193 
Math exception, 57-60, 68, 176-177, 197 
Setting, (SFLAG), 192 
System, 196-201 
Testing, (FLAG), 191-193 
User, 193-196 
FLO function, 48 
FOR..HEsT statement, 185-187, 269 
Form of subprogram (SUE, ENO SUB), 204-205 
Form of user-defined function (GEF FH, 
EHO EF), 218-219 
Format string (IMAGE, DISF USIW I, 
PRINT USIHG), 228-232 
Formatting, printer and display, 224-239 
Formatting numbers, 54-56 
4 status annunciator, 30 
FF function, 48 
Fractional part (FF), 48 
FREE FORT statement, 105-106 
Functions 
Numeric, 47-53 
Statistical, 78-89 
String, 74-77 
User-defined, 218-222, 269 


G 


[9] key, 11 
g status annunciator, 30 
COISF statement, 137-139 
Generating random integers, 53 
Global environment, 211 
GLSUE statement 
executed from keyboard, 150 
executed in program, 179 
GOTO statement 
executed from keyboard, 158 
executed in program, 179 
Graphics, display, 137-139 
Graphics, displaying (G01 =F), 137-139 
Greater-than (>), 62 
Greatest integer (IMT or FLOGF), 48 





H 


Halt program execution, 153 

Head, card reader, cleaning, 286 

Hexadecimal to decimal conversion (HTL), 48 
HTC function, 48 | 
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I—J 
IEEE proposal for handling math exceptions, 59- 
60, 62 


IF..THEH...ELSE statement,188-189 
IF...THEH statement, 187-188 
IMAGE statement, 229-232 
Implied [.ISF statement, 24, 67, 226 
Implied result in CALC mode, 38, 40 
Independent RAM, 104-108 
Declare (FREE FORT), 105-106 
incorporate, into main RAM (CLAIM FORT), 
107 
Index of keywords, inside back cover 
Inexact result (IH), 57-60 
+Inf, ~In? values, 59-60 
IHF function, 60 
Infinity (+I nf, -Int, IHF), 59-60 
Information, dealer and product, 280 
IHIT display, 13-14, 193, 273-274 
Initializing the HP-71 (I1HIT), 13-14, 153, 193, 
273-274 
IHFLT statement, 241-244, 269-270 
Insert cursor, 19-20, 23 
Installing card reader, 285 
IHT function, 48 


Interference, radio/television, potential for, (U.S.A. 


only), 279 
Integer division (DI '!), 47 
Integer part (IF), 48 
INTEGER statement, 57, 69-70 
Integers, generating random, 53 
Integration, trapezoidal rule, program, 76 
Interrupting program, 152-155 
Invalid operation (1''L), 57-60, 68 
IMs flag, 57-60 
IF function, 48 
key, 21 
IVL flag, 57-60, 68 


K 


Key definitions (EF EE’), 28, 121-124 


Cancelling, 128 
Types of, 124 
Viewing and editing, (FETCH KE‘, EETDEF, 
(A)(ViEW)), 125-126 
KEY files, 99, 127-128 
Key name, 121-124 
by character, 122-123 
by number, 122-124 | 
Specifying, 122-124 
Key pressed, identity of, (KE‘'#), 130-131 





Key pressing 
Causing program to simulate, (FUT), 131-132 
Test for, (KEY OOHH), 129 
Keyboard, 11-12 
calculations, 18-20, 36-46 
entry of data and expressions (IHFIIT), 241- 
244, 269-270 
Normal, 28-29, 121 
operation, 11-12 
Shifted operations on, 11 
User, 28-29, 122-124, 126 
Keyboard/program interactions, 129-132 
KEYOEF£ function, 125-126 
KE‘ function, 130-131 
KE‘ OOWH function, 129 
Keys, 11-13, 15-16, 21. See also individual key 
symbol. 
alternate operations, 11 
Immediate execute, 12 
Letter, lowercase, 11 
Letter, uppercase, 11 
primary operations, 11 
Typing aid, 12 
User defined, 28-29, 121-124 
Keystroke presentation conventions, 13 
Keyword index, inside back cover 


L 


Labels, statement, 146-147 
key, 11, 140 
Left arrow key ({<]), 15 
_EH function, 74 
Less-than (<), 62 
LET statement, 67, 269 
Letter case control. See lowercase/uppercase control. 
LEX files, 99, 160, 174 
_GT function, 50 
Line 
display scrolling rate, 26 
length, 14 
Program. See program line. 
width control (WIQTH, PH IOTH), 232-233 
key, 21 
Linear regression (LF), 84-85, 88 
LIHPUT statement, 244-245 
LIST statement, 127, 156-157 
LH function, 50 
Load and execute magnetic card program 
(FUR > CARO, CHAIH +: CARD), 289, 291 
Local environment, 211 
LOCKE statement, 139 
Log, natural. See natural log. 
Lac function, 50 





Logical operators, 62-64 
Ltidé& function, 50 
_LOGF 1 function, 50 
Loops, program. See program, loops 
Low battery indication (BAT), 30, 271 
Lower bound of arrays, setting (GF TIOH BASE), 
68-69, 70, 72, 73, 270 
Lowercase/uppercase control 
by flag (-15), 199 
by key ((Lc]), 11, 140 
by statements (LC, LO OH, LC OFF), 140 


M 


Magnetic card, 287-293 
Marking, 286 
operations. See entries under card reader 
organization, 287 
Pulling, through card reader, 287-289 
Magnetic card reader. See card reader 
Main 
environment, 211-213 
program, 203 
Main RAM, 104-108 
Reclaiming (CLAIM FORT), 107 
Manual conventions, 14, 16, 21, 34 
Marking magnetic cards, 286 
Math exception 
as error, 176, 269-270 
as warning, 177, 269-270 
flags (IVIL, OVE, OF, UNF, IHS), 57-60, 68, 
176-177, 197 
Recovering from (GEFAULT OH, 
DEFRULT OFF, OEFAULT EXTEHD), 58, 
269-270 
Value for, (TE AF), 59-60 
Math exceptions, IEEE proposal for handling, 59- 
60 
MAS function, 49 
Maximum (MAH), 49 
MASREAL function, 61 
MEM function, 107-108 
Memory 
RAM, 103-108, 273 
reset, 13-14, 153, 193 
port RAM/ROM data (SHOW FORT), 108 
ROM, 103-105, 273-274 
structure, 103-108 
Unused amount of, in RAM (MEM), 107-108 
Memory lost display, 14 
MERGE statement, 116, 128 
MIN function, 49 
Minimal BASIC, deviations from, 269-271 
Minimal BASIC, extensions to, 268-269 
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Minimum (MIH), 49 

MIHREAL function, 61 

MOO function, 49 

Module, plug-in, 103-108, 273 

Modulo (HOD), 49 

Movie program, 138 

Moving file pointer (FEZTORE #), 258 
Multiple assignment statements, 67 
Multiplication operator (+), 47 
Multistatement line, 146 


N 


HAME statement, 27, 101, 145 
Names 
Device, 110-114 
File, 22, 109-110 
Numeric variable, 68 
Program (BASIC file), 21-22, 101, 109-110, 143- 
145 
String variable, 72 
HAH function, 59-60 
Halt value, 59-60, 68 
Natural antilog (EXF), 50 
Natural log (LOG or LH), 50 
Natural log (LOGFi), 50 
Nested 
loops. See program, loops, nested 
subroutines. See program, subroutines, nested 
HET statement, 185-187, 269 
Normal keyboard, 28 
Normal/User keyboards, switching between 
(USER, USER OH, USER OFF, (User], 
(1 USER}), 28, 126 
Not a number (HaH), 59-60, 68 
Not a number (HAH), 59-60 
Not-equal-to (#) logical operator, 62 
HOT logical operator, 62-63 
Null string, 72, 268 
Hut function, 74, 77 
Number 
formatting, 54-56 
of digits flags (-17 through -20), 199-200 
rounding, displayed, 56 
Numbers, range of, (MIHREAL, EFS, MAXFEAL), 
61 


Numeric 
functions, 47-53 
precision (AF TIGH FOUHD), 56 
variable precision (FEAL, SHORT, INTEGER), 
57 
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O 


Off, automatic, 13 
key, 13 
OH ERROE statement, 172 
OM.GOSUE statement, 181 
OH..GOTO statement, 181 
key, 13 
OH TINER#...GOSUB statement, 183-184 
OH TIMNER#...G07TO statement, 182, 184 
1 status annunciator, 30 
key, 28-29, 126 
Opening data file (HSS1GH #), 248-249 
Operating precautions, 267-268 
Operating system version (iEF#), 267 
Operation, verifying proper HP-71, 273-274 
Operations unsupported in CALC mode, 46 
Operator precedence, 64 

in CALC mode, 41-42 
Operators 

Arithmetic, 47 

Logical, 62-63 

order of precedence, 64 

Relational, 62 
OPTIOWH AHGLE DEGREES statement, 50 
OP TIOH AWHGLE FPAOQIANS statement, 50 
CF TIOH BASE statement, 68-69, 70, 72-73, 270 
OPTIOW FOUHOG HEAR statement, 56 
OPTION FEOUNC HEG statement, 56 
OF TICH ROUND FOS statement, 56 
OF TIOH ROUHO ZERO statement, 56 
Cie logical operator, 62-63 
Order of evaluation, 64 
Organization of magnetic cards, 287 
Output spacing (THE, semicolon (:), comma (. )), 

226-227 | 

Overflow (CF), 57-61 
OUF flag, 57-60 


P 


Parameter list. See parameters 
Parameter passing (ZHLL, SUB), 204-210, 263- 
264 
Parameters 
used in CALL statement, 206-210 
used in DEF FH statement, 218-219 
Parentheses 
in array declarations, 69-72 
in numeric expressions, 64 
in numeric functions, 48-52 
in string functions, 74-75 
Passing channel number (CALL, SUE), 263-264 
FALISE statement, 154 
:P Ro keyword, 289, 292-293 





Percent (*:) operator, 47 
FI function, 49 
FLIST statement, 157 
Pointer, data file, 252-253, 258 
FOF statement, 180 
Port, 104-108 
Fis function, 74-75 
Potential for radio/television interference (U.S.A. 
only), 279 
Power consumption, 271 
Power supply, 271-273 
Precedence of operators, 64 
in CALC mode, 41-42 
Predicted values (FFED‘!), 85-86, 89 
Pressed key test (EE DOMH), 129 
PRGM status annunciator, 25, 30 
Print list, 230 
FRIHT # statement, 250-252, 256-263 
FR IMT statement, 225 
Quotation marks in, 67 
FRIHT USIWG statement, 230-232 
Printer control, 232-234 
Printing information, 224-234 
Private magnetic cards (:FCEE), 289, 292-293 
FRIVATE statement, 117-118 
Product information, 280 
Program. See also subprogram and program line 
branching, conditional (IH...GOSUEB, 
OH..GOTO, OH, TIMER R.GCOSUE, 
OH TIMER#..G0TO), 181-184 
branching, unconditional (GOSUE, GOTO, 
RETURH, POF, CALL, CHAIN), 179-181 
Chained, 151-152 
changing of array dimensions, 70-71, 73 
Conditional, branching. See program, branching, 
conditional 
Conditional execution of, lines. See program, 
line(s), conditional execution of 
data (CATA, FEAC, RESTORE), 245-247, 269 
data pointer, resetting (FESTORE), 246-247 
Editing, 22-26, 156-159 
Ending execution of (2 TOF, EHO), 155 
Entering, 22-25, 143-149, 269 
environment, 153, 210-215 
Execute, 25, 149-152. See also entries under pro- 
gram, line(s). 
Execute, at specified line (RUM, GOSUE), 149- 


150 

Execute current file (RUH, GOSUE, [RUN)), 25, 
149-150 

Execute magnetic card (RUH : CARO, 


RUM i PCRO, CHAIN : CARO, 
CHAIHW :FCRD), 289 





Program, cont. 
Execute specified, (HUH, CALL, CHAIN), 150- 
152 
execution, single step ((f][SST]) key, 168-171 
execution, trace flow of (TEFACE FLOW, 
TRACE VARS), 166-167, 171 
Fibonacci, 216-218 
file, 27, 143-144 
Halting, execution, 153-155 
input, 22-25, 143-149, 269 
Interrupting, 152-155 
line, adding, to program, 158 
lines, automatic numbering of (ALTO), 149 
line(s), conditional execution of (IF...THEH, 
IF..THEH..ELSE), 187-189 
line, current, 154, 158 
line(s), deleting (DELETE), 158-159 
line(s), displaying (FETCH, LIST, FLIST, (aj, 
[v]), 21, 156-158 
line, format of 145 
line, keying in, 22-25, 145-149 
line label. See statement labels 
line, multistatement, 146 
line number, 145 
line, renumber (REHUMEER), 159 
line(s), unconditional execution of (GQ SUE, 
GOTO, RETURN, FOF, CHAIH), 179-181 
Load magnetic card (FUH : CARO, 
RUM SPCRO, CHAIN : CARD, 
CHAIH :FPCRO), 289 | 
loops (FOR..HE#T), 185-187, 269 
loops, nested, 186-187 
merging, 116 
Movie, 138 
name, 21-22, 101, 109-110, 143-145 
protection, 117, 127, 292 
Resuming, execution ((f][CONT], CIMT), 155 
Retrieving data from (FEAL), 246 
Running. See program, execute. 
Saving (EDIT, HAME), 21-22, 27, 101, 143-145 
Storing data in (DATA), 245, 269 
subroutines, 179-184 
subroutines, nested, 179 
Suspending, execution ([ATIN], FAUSE, HAIT), 
153-154 
Tracing, execution (TRACE FLO), 166-167 
Tracing, variable assignment (TRACE WAFS), 
167 
Trapezoidal rule integration, 76 
Twocount, 130 
Unconditional, branching. See program, branch- 
ing, undonditional 
Unconditional execution of, lines. See program, 
line(s), unconditional execution of 
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Program/keyboard interactions, 129-132 

Prompts, input (IHFLIT), 243 

Proper HP-71 operation, verifying, 273-274 

FROTECT statement, 289, 292 

Protected display fields (HIHDOlH), 135-136 

Protected display fields using escape sequences, 

237-239 

Protecting files (SECURE, UMSECURE, 
PRIVATE), 117-118, 127 

Pulling magnetic cards through card reader, 287- 

289 

FURGE statement, 115-116, 127 

FUT function, 131-132 

FHIOTH statement, 232-233 


Q 
Quotation marks, 67, 72, 109, 269 


R 


FAC function, 52 
RAD status annunciator, 30 
RAOQTAWS statement, 50, 270 
Radians to degrees (TIE), 52 
Radio/television interference, potential for (U.S.A. 
only), 279 
RAM, 13, 103-108 
Independent, 104-108 
Main, 104-108 
Plug-in, modules, 103-108, 273 
port data (SHOW FORT), 108 
Unused memory in (HEM), 107-108 
Random access memory, 13, 103-108. See RAM 
Random data recall (FEAC #), 260 
Random data storage (ZREATE, FESTORE #, 
PRIHT #), 256-260 
Random integers, generating, 53 — 
Random number (FE HE), 52-53 
RAHOOMIZE function, 52-53, 271 
Range of numbers (MIHFEAL, EFS, MAXFEAL), 
61 
REAGQ # statement, 254-257, 260 
Read-only memory (ROM), 103-105, 273-274 
FREAD statement, 246, 269 
Reading calendar date (DATE, CATE), 17, 90-91 
REAL statement, 57,69 
Recalling data randomly (FEAD #), 254-257, 260 
Recalling data sequentially (FESTORE #, 
READ #), 254-263 
Recalling program data (FEAL), 246, 269. See 
accessing data files 
Reclaiming memory (DES TEC), 67-68 
Records, file, 256-260 
Recovering from math exceptions, 58, 269-270 
Recursive subprograms, 214-218 
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Recursive user-defined functions, 222 

FEC function, 49 

Redefining the keyboard (DEF KE‘), 28, 121-124 

Reduction (FED), 49 

Reference parameters (ALL), 206 

Referencing user-defined function, 220 

Relational operators, 62, 64 

Remainder (Fh0), 49 

Remove write-protection from magnetic card 
(UHFROTECT), 289, 292 

Removing card reader, 285 

RFEHAME statement, 101, 115, 127 

RENUMEER statement, 159 

Replace cursor, 14, 23 

Replacing batteries, 272 

RES function, 49 

Reserved words for file names, 110 

RESET CLOCK statement, 96 

Reset data pointer in program (FES TORE), 246- 
247 

Reset HP-71 (IHIT), 13-14, 193, 273-274 

RESET statement, 193 

RESTORE # statement, 254, 258, 262-263 

RESTORE statement, 246-247 

Restricting HP-71 use (LUCK), 189 

Result (FES), 49 

Resuming program execution, ([f][CONT], CONT), 
155 

Retrieving data sequentially (RESTORE #, 
REAC #), 254-263 

Retrieving file data randomly (FEAD #), 254-257, 
260 

Retrieving program data (FEHL!), 246, 269. See 
accessing data files 

Return key, 13 

RETURFH statement, 179 

Right arrow key ((>]), 15-16 

FiO function, 49 

EMO function, 52-53 

ROM, 103 

Plug-in, modules, 103-108, 273 
port data (SHOW FORT), 108 

Rounding, displayed number, 56 

Round-off setting flags (-11, -12), 198 

[RUN], 25, 27, 41, 149 

ELI : CARO statement, 289 

RUM +: PCRO statement, 289 

ELIE statement, 27, 149-151 

Run-time errors, 163-165 

Running program. See program, execute. 


S 


Sample correlations (TOFF), 84 
Saving programs (ECIIT, HAME), 21-22, 27, 101, 
143-145 
=I statement, 55 
Scientific display format (201), 55 
Scrolling rate, display, 26 
SDATA files, 99, 247-264 
Search order for files, 112 
SECURE statement, 117-118, 127 
Securing HP-71 contents (LUCE), 139 
Semicolon (;) for output spacing, 227 
Sequence, escape, 234-239 
Sequential data access, file pointer, 252-253, 258 
Sequential data recall (RESTORE #, READ #), 
254-263 
Sequential data storage (FF IHT #), 250-253, 
256-263 
Serial number of HP-71 (JER #), 267 
Service, 276-279 
contracts, 279 
in Europe, 276-277 
in United States, 276 
International, 277 
repair charge, 278 
shipping instructions, 278-279 
warranty, 278 
Set, character, 132-135, 268 
SETOATE statement, 17, 90-91 
SETTIME statement, 17-18, 92-95 
Setting 
clock speed. See adjusting clock speed 
date (SETOATE), 17, 90-91 
lower bound of arrays (QF TIOH EASE), 68-69, 
70, 72-73, 270 
system, 211 
time (SETTIME), 17-18, 92-95; (HOWAES), 92- 
93 


SFLAG, 192 

SIH function, 49 

Shipping instructions for service, 278-279 

SHOET statement, 57, 69-71 

SHOW FORT statement, 108 

Sign (26H), 49 

Simplified syntax, 34 

“IH function, 52 

Single-step execution (([f](SST]), 41-42, 168-171 

Single quotation marks, 67, 72, 269 

Smallest integer (ZEIL), 48 

Spacing output (THE, semicolon (:), comma (. )), 
226-227 

Specify magnetic card file (ZAREO, : CARO, 
:-F OREO), 289-293 

Speed correction factor for clock, 92-96 





iF function, 49 
key, 41,168-171 
Standard deviations ({f:E4'), 83-84 
Standard display format (2T), 55 
=TRAR TUF statement, 139-140 
TAT statement, 78-80, 87 
Statement(s) 
execution (automatic) at start-up (2 TAHRTUF), 
139-140 
Concatenating, 22, 67, 146 
labels, 146-147 
Suspend execution of program, 153-154 
Statistical statements and functions, 78-89 
Status annunciators, 15-16, 20, 22, 30 
= Tl) statement, 55 
STEF keyword, 185-187 
= TOF statement, 155 
Storing and retrieving data, 240-264 
Storing data randomly (7FEATE, RESTORE #, 
FRIHT #), 256-263 
Storing data sequentially (FF IHT #), 250-253, 
256-263 
TRE function, 75, 77 
String(s), 71-77 
character code to character (HE #), 75, 77 
concatenation (£:) symbol, 73 
default (THFiUT), 243-244 
first character to character code (HIM), 74, 77 
functions, 74-77 
length (LEH) function, 74 
lowercase to uppercase (LIF FC#), 75 
Null, 72, 268 
Numeric value to string (3 7TE#), 75, 77 
Quoted, 71-72 
String to numeric value (Al), 74, 76 
Substring position (FS), 74-75 
Substrings, 73-75 
variables, 71-73 
Structure of memory, 103-108 
SUE statement, 204-205 
Subprogram, 151, 203-218 
channel number, passing (CALL, SUE), 263-264 
environments, 210-215 
Form of (SUE, EHD SUE), 204-205 
parameter passing (CALL, UE), 204-205, 263- 
264 
Recursive, 214-218 
Transfer program execution to (CFL. i.), 205-210 
SUE Scr Le t warning/error message, 68 
Subtraction (~) operator, 47 
Summing data points in statistical array (TOTAL), 
82-83 
SUSP status annunciator, 30, 153, 155 
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Suspend statement, 153 
Syntax 
errors, 163-164 
guidelines, 34 
Simplified, 34 
System flag(s), 196-201 
Angular setting (-10), 197 
Annunciator (-57, -60 through -64), 201 
Base option (-16), 199 
BASIC prompt (-26), 200 
Beeper (-2, -25), 197 
Continuous-on (-3), 197 
Display format (-13, -14), 198-199 
EXACT (-46), 200 
Lowercase (-15), 199 
Math exception (-4 through -8, IML, O42, OVE, 
WHE, THE), 57-60, 68, 176- 177, 197 
Number of digits (-17 through -20), 199-200 
Round-off setting (-11, -12), 198 
User keyboard (-9), 197 
Warning message (-1), 196 
System version, operating (WEF), 267 
System settings, 211 


T 


THE statement, 226-227 
TAH function, 52 
Technical assistance, 280 
Television/radio interference, potential for (U.S.A. 
only), 279 
TEXT files, 99, 247-264 
THEM keyword, 187-189 
3 status annunciator, 30 
Time. See clock 
TIME function, 94 
TIME function, 94 
Timer program branching. See program, branching, 
conditional 
Timers, 182-184 
Timers, deactivating (2FF TIMER #), 184 
Tone 
loudness, controlling, 32-33 
_ Producing 32-33 
t Fi tilt statement, 166-167 
fF EF statement, 168 
AES statement, 167 
iF OEM statement, 160-161 
rE AE function, 59-60, 68 
Trapezoidal rule integration program, 76 
2 status annunciator, 30 
Twocount program, 130 
Typing 
aids, 12, 21-22, 24, 26, 28 
errors, correcting, 16, 22-23, 25-26 
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Unary minus (—) operator, 64 
Unconditional program branching. See program, 
branching, unconditional 
Underflow (IHF), 57-61 
WHF flag, 57-61 
Unordered (7) operator, 62 
UWHFREOTECT statement, 289, 292 
WHSECURE statement, 117-118 ,127 
Unsupported operations in CALC mode, 46, 48 
Uppercase/lowercase control. See 
lowercase/uppercase control 
UFREC# function, 75 
key, 28, 29, 126 
WISER statement, 126 
USER status annunciator, 30 
User. See also user-defined functions 
flags, 193-196 
key definitions (DEF EE’), 28, 121-124 
keyboard, 28-29, 122-124, 126 
keyboard flag ( -9), 197 
User-defined functions, 218-222 
Environment of, 220-221 
Forms of (EF FH, EHO OEF), 218-219 
Recursive, 222 
Referencing, 220, 269 
User/Normal keyboards, switching between 
(USER, USER OH, USER OFF, [User], 
(.USER]), 28, 126 
WISER OFF statement, 126 
USER OH statement, 126 
Using magnetic cards, 287-293 


Vv 


‘AL function, 74, 76 
Value parameters (CALL), 206 
Variable (numeric) precision (QF TIGQH FOUND), 
56 
Variables, 66-77 
Array, 68-73 
Default values for, 67-68, 72, 268 
Names of, 68, 72 
Nonexistent, 68, 72 
Sharing, between keyboard and programs, 67 
String, 71-73, 268 
WER function, 267 
Verifying proper HP-71 operation, 273-274 
key, 126 
Viewing 
angle, 29-30 
key definitions (FETCH EE‘, EEYOEF, 
()[ViEW)), 125-126 
program lines (FETCH, LIST, PLIST, [a], 
(v)), 21, 156-158 
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LIA IT statement, 154 
Warning message, 13, 68, 175-176 
Math exception, 68, 177, 269-270 
flag (-1), 196 
in CALC mode, 46 
Warranty 
on HP-71, 274-276 
on service, 278 
WIQTH statement, 232-233 
WIHOGH statement, 135-136 
Workfile, 27-28, 100, 101, 144-145 
Copying (C UF’), 145 
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This index lists the HP-71 keywords by category and gives a page number where that keyword is in- 
troduced in this manual. Some keywords appear in more than one category. 


Program Entry/Editing Program Control Logical and Relational General Math (continued) 
AUTO 149 (continued) Operators OPTION ROUND 56 
DELETE 158 OH TIMER # 182 AHO 63. WF 57 
EQIT 143 OH...GOSUE 181 EXOR 63 FANDONIZE 52 
FETCH 157 OH.GOTO 181) HOT 63 FED 49 
TST 157) OH..RESTORE — OF 63 FES | 49 
HAME 145 PAUSE 154 = 62 EMO 49 
PLAS | 157 FUR 180 # 62 FHD 52 
PRIVATE 116 FETURH 179 => 62 SGH 49 
REM (!) 22 « STOF 155 = 62 SIE 49 
REMUMBER 159 SUE 204 <= 62 SET 49 
SECLRE 116 WAIT 154 > 62 UHF 57 
TRAHSFORM 160 >= 62 
LHSECURE 116 Debugging ? 62 Logarithmic Operations 
ig 146 EF OHT 155 EXP 50 
NEFALLT 58 Arithmetic Operators Ewe td | 50 
Program Execution ERRL 175 + 47 EXPOMEHT 50 
PALL 151 ERRMS 175 - AT ‘eae 50 
CHAIW 151 ERRH 173 + 47 LH 50 
COW T 155 ON ERROR GOSUE 172) - 47 Lan 50 
RU 149 OH ERROR GOTO 172 OFM (-) 47 Locia 50 
PAUSE | 154 * 47 LOGFI 50 
Program Control TRACE 166 = 47 
EYE 184 Trigonometric 
CALL 9905 Storage Allocation General Math Operations 
CHALH 180 CLAIN FORT 107 AES 48 ACOs 52 
COEF FH 218 DESTROY 67 WEIL 48 ARS 52 
EHO 155 DI 69 CLASS 60 AHGLE 52 
EHO CeEF 219 FREE FORT - 105 Ole 57 aASIH 52 
ENO SUB 204 IHTEGER 70) EXSPOHENT 50 ASH 52 
F HH 220 NEM 107. FRCT 49 ATAH 52 
FORME ST 185 OFPTIOW BASE 68 FLOUE 48 ATH 52 
GOSUEB 179 FEAL 69 FF 48 cos 52 
GOTO 179 SHORT 70 =6oINT 48 (CEG 52 
IF..THEM...ELSE 187 SHOW FORT 108 IHX 57 DEGREES 50 
OFF 13. STAT 79 +#xIF 48 OPTION AHGLE 50 
OFF ERROR 172 TL 57 FAD 52 
OFF TINER 184 LET 67 FACIAWS 50 
OH ERROR GOSUE 172 MAR 49 SIH 52 
OH ERROR GoTo 172 NIH 49 TAH 52 


Moo 49 





Statistics 


HOG 
LLSTAT 
To Be Fe 
CROP 
LF 
MEAH 
PREQ\ 
SOE\ 
Sra 
TOTHE 


Constants 
EFS 

IHF 
MAMREAL 
MINREAL 
HAW 

FI 


Strings 


CHEE 
LEH 
HUM 
RS 
STR 
UWPROE 
WAL 
WERE 


Input/Output 
HSESTGH # 
BEEF 

BEEP OFF 
BEEP OM 
LOM TRAST 
cory 
TREATE 
DATA 
DELAY 
DiSP 
DTSP 
CISPs 
EHOLIHE 


USING 


73 
75 


74 
74 
75 
75 
74 
267 


Input/Output (continued) 


EHG 

FIs 

BOISP 
GOLSFS 
IMAGE 
IMFUT 

KEY OOH 
Lit 

LIHFUT 
eee a) 

ON. RES TORE 
PLIST 
FRIHT 
FRIHT USTIHG 
FRINT # 
PUT 

FMW IOTH 
REA 

REHO # 
RESTORE 
RESTORE # 
SI 

STO 

THE 

UPR 
USER 
WIOTH 
WIKHOOL 


Graphics 

GOISP 

GCOLlSPS 

File Management 
HOOR + 

CAT 

CAT ALL 

CATS 
CLAIM 
Lop 
CREATE 
EQIT 
FREE 
MEM 
MERGE 


FOR T 


FORT 


56 

55 
137 
137 
231 
241 
129 
140 
244 
157 
157 
225 
230 
250 
131 
232 
246 
254 
246 
254 

55 

55 
226 

75 
126 
232 
135 


137 
137 


119 
107 
112 
248 
143 
105 
107 
116 


File Management 
(continued) 
HARE 
PRIVATE 
FROTECT 
PURGE 
REHAME 
SECURE 
SHOW FORT 
TRANSFORM 
UHPROTECT 
UHSECURE 


Time and Date 
AD IAB S 
ACIS T 

AF 

DATE 

DATE 

EXACT 

RESET CLOCK 
SETOATE 

oe TT oME 
TIME 

TIMES 


System Settings 
and Flags 
CFLAG 
REFAULT 
DEGREES 
DELAY 

ee 

FLAG 

IH 

TL 

OPTION ANGLE 
OPTION BASE 
OPTION FOUND 
i} iJ F 

RAQTAHS 
RESET 

SFLAG 

T RAF 

LHF 


145 
116 
292 
115 
115 
116 
108 
160 
292 
116 


Customization and 


Keyboard Control 
AOORS 
CHARSET 
CHARSET# 
CONTRAST 
HEF KEY 
MELAY 
OTHE 
FETCH KEY 
FIX 

HTD 
IMAGE 
KEY 

KEYS 
KEYOEFS 
KEYOOMN 
ine 

LOCK 
FEEKS 
FORE 

Ply 

STAR TUF 
USER 

WOH OC 
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How to Use This Manual (page 6) 

Getting Started (page 10) 

Calculating with the HP-71 (page 36) 

Variables: Simple and Array (page 66) 

Statistical Functions (page 78) 

Clock and Calendar (page 90) 

File Operations (page 98) 

Customizing the HP-71 (page 120) 

Writing and Running Programs (page 142) 

Error Conditions (page 162) 

Branching, Looping, and Conditional Execution (page 178) 
Flags (page 190) 

Subprograms and User-Defined Functions (page 202) 
Printer and Display Formatting (page 224) 

Storing and Retrieving Data (page 240) 


Owners Information (page 266) 
Accessories Included With the HP-71 (page 282) 
Using the HP 82400A Magnetic Card Reader (page 284) 
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